【技术派部署篇】Windows本地部署技术派

一、技术派简介

技术派是一个采用 Spring Boot、MyBatis-Plus、MySQL、Redis、ElasticSearch、MongoDB、Docker、RabbitMQ 等技术栈的社区系统，其 1.0 版已正式上线。该项目的技术栈按阶段集成引入，开发者可根据自身需求选择不同版本进行学习。

二、环境依赖安装

1. JDK8 安装

技术派最小依赖的 JDK 版本为 8，且最高也建议使用 8 版本，以避免后期出现兼容性问题。
下载地址：https://www.oracle.com/java/technologies/downloads/#java8-windows
下载.exe 安装包，双击进行安装，并记录安装路径。
环境配置：
- 右键点击“我的电脑”，选择“属性”，进入“高级系统设置”，点击“环境变量”。
- 在“系统变量”中新建变量，变量名设为“JAVA_HOME”，变量值为 JDK 安装路径。
- 编辑“Path”变量，添加“%JAVA_HOME%\bin”。
- 验证：打开命令提示符（CMD），输入“java -version”，若能正确显示 JDK 版本信息，则安装成功。

2. MySQL 安装

版本支持：5.7.x或8.x+。
下载地址：https://dev.mysql.com/downloads/installer/
下载.exe 安装包，双击进行安装，并记录安装路径。
配置环境变量：
- 右键点击“我的电脑”，选择“属性”，进入“高级系统设置”，点击“环境变量”。
- 在“系统变量”中新建变量，变量名设为“MYSQL_HOME”，变量值为 MySQL安装路径。
  - 编辑“Path”变量，添加“%MYSQL_HOME%\bin”。
  - 验证：重新打开命令行工具，输入mysql -uroot -p，若能成功连接 MySQL，则说明环境变量配置成功。

3. Redis 安装

下载地址：https://github.com/MicrosoftArchive/redis/releases
使用 MSI 安装包安装：下载 MSI（Microsoft Installer）格式的 Redis 安装包，双击运行安装程序，按照安装向导的提示进行操作，选择安装路径等选项即可完成安装。安装完成后，可在命令行中进入 Redis 安装目录，使用redis-server命令启动 Redis 服务。
使用免安装绿色版：下载免安装的绿色版 Redis 压缩包，解压到指定目录。打开命令行，进入解压后的目录，输入redis - server redis.windows.conf命令即可启动 Redis 服务。

4. Maven 安装

Maven 是项目的构建工具，在导入技术派项目时需要使用它来构建项目。
下载地址：https://maven.apache.org/download.cgi
选择.tar.gz 或.zip 包，解压到本地指定位置。
环境配置：
- 新增环境变量“MAVEN_HOME”，变量值为 Maven 解压路径。
- 更新“Path”变量，添加“%MAVEN_HOME%\bin”。
- 验证：在终端中输入“mvn -version”，若能显示 Maven 版本信息，则安装成功。

5. IDEA 安装

推荐使用 IDEA 作为技术派的开发工具，有钱的用户可以选择 Ultimate 版本（学生可申请教育版），个人也可使用社区免费版。
- 下载地址：https://www.jetbrains.com/zh-cn/idea/download/?section=windows
- 新手建议安装通义灵码或字节 MarsCode 插件，以便在出现问题时利用 AI 定位和解决。
- 插件安装：
  - 安装完毕后，必须安装“lombok”插件，否则会导致技术派工程编译异常。
  - 安装方式：打开“file -> settings -> plugins -> Marketplace”，找到“lombok”插件（小辣椒图标），点击安装并重启 IDEA。
  - 推荐安装的插件还包括：Maven Helper（让依赖管理更简单）、MyBatisx（支持 mybatis 的 xml 与 mapper 接口互相跳转）、Rainbow Brackets（使括号更易区分）、GenerateSerialVersionUID（自动生成类的 serializeId）、CodeGlancePro（在代码编辑区域添加类似 sublimetxt 的滑动窗口）。

三、本地编译运行

加载源码
- 源码地址：
  - 项目仓库（GitHub）：https://github.com/itwanger/paicoding
  - 项目仓库（码云）：https://gitee.com/itwanger/paicoding
- 若本地未安装 git，推荐安装；也可通过其他方式下载源码。
- 使用 IDEA 打开项目：启动 IDEA，选择“File -> Open”，然后选择下载的源码路径。打开项目后会构建索引，耗时取决于网络环境，构建完成后项目模块标识会发生变化。
开发环境配置
- 本地项目加载后，在启动前需查看本地环境变量配置，默认使用 dev 开发环境（无需额外设置）。
- 打开“paicoding-web/src/main/resources-env/dev”目录下的配置文件“application-dal.yml”，重点修改数据库和 Redis 的用户名和密码：
  - 数据库：“spring.datasource.username”和“spring.datasource.password”分别设置为本地数据库的用户名和密码；若要使用其他服务器上的数据库，需修改“spring.datasource.url”中的地址和端口号；默认数据库名为“database.name = pai_coding”，可在“src/main/resources/application.yml”中查看。
  - Redis：当不使用密码时，“password”为空；若有密码，则需设置为对应的密码。
本地编译运行
- 启动 MySQL 和 Redis。
- 找到启动入口：“paicoding-web”模块中的“com.github.paicoding.forum.web.QuickForumApplication”。
- 在 IDEA 中右键点击启动入口，选择“Run or Debug”方式启动项目。
- 首次启动会自动创建数据库表，并初始化一些用户、博文等相关数据。启动成功的标识是控制台上会出现相应的输出，点击输出中的链接即可进入技术派首页。

四、常见问题及解决方法

在部署过程中，可能会遇到一些问题，以下是部分常见问题及解决方法：

数据库无法自动创建：部分用户反馈不能自动创建数据库，此时可以先自行创建一个空数据库，项目运行时会自动创建表。若仍存在问题，可查看日志以确定报错原因。
MySQL 密码修改问题：安装 MySQL 8 时，密码修改方式可能与文档中介绍的不同，可参考 https://blog.csdn.net/qq_38935605/article/details/127509902 进行操作。
项目报错问题：如遇到“Cannot resolve property”等报错，可能是配置文件格式问题，例如在“password：”后面添加一个空格后再输入密码可能会解决问题；若遇到“PublicKey Retrieval is not allowed”报错，可在配置文件里加上“&allowPublicKeyRetrieval=true”配置；若 test 文件夹中有重复的类，可将重复类的代码注释掉。
JDK 版本兼容问题：若使用较高版本的 JDK（如 JDK23）无法运行项目，可将 JDK 版本改为 8，参考 https://stackoverflow.com/questions/77171270/compilation-error-after-upgrading-to-jdk-21-nosuchfielderror-jcimport-does-n 解决相关问题。