神仙开会《天迹OL》技术内测场面火爆

一、前置工具准备（零门槛，按步骤直接操作即可）

1.1 支持系统说明

本流程支持Windows10/11 64位、MacOS12+、Ubuntu20.04+，所有步骤通用，仅安装方式略有区别，下文分场景说明。

1.2 工具下载与安装验证

• Git（拉取内测源码用）

  Windows64位直接下载安装包：https://github.com/git-for-windows/git/releases/download/v2.45.1.windows.1/Git-2.45.1-64-bit.exe，安装全程默认点击下一步即可。

  MacOS用户执行命令：brew install git

  Ubuntu用户执行命令：sudo apt update && sudo apt install git -y

  安装完成后打开终端/CMD，输入git --version输出版本号即安装成功。

• JDK11（后端运行依赖）

  Windows64位直接下载安装包：https://download.oracle.com/java/11/latest/jdk-11_windows-x64_bin.exe，安装默认下一步，安装完成后配置环境变量：

  1. 桌面右键【此电脑】→【属性】→【高级系统设置】→【环境变量】，在系统变量区域点击【新建】，变量名填JAVA_HOME，变量值填你的JDK安装路径，默认是C:\Program Files\Java\jdk-11.0.23

  2. 找到系统变量里的Path，点击编辑，新建一行添加%JAVA_HOME%\bin，保存所有设置。

  MacOS/Linux用户用sdkman安装，执行以下命令即可：

  
  curl -s "https://get.sdkman.io" | bash
  source "$HOME/.sdkman/bin/sdkman-init.sh"
  sdk install java 11.0.23-amzn
  
  

  验证：终端输入java -version输出版本为11.x即成功。

• MySQL8.0（数据存储依赖）

  Windows64位免安装版下载地址：https://cdn.mysql.com/Downloads/MySQL-8.4/mysql-8.4.0-winx64.zip，解压后打开CMD进入解压目录的bin文件夹，执行命令初始化：

  
  mysqld --initialize --console
  mysqld install
  net start mysql
  
  

  初始化完成后，控制台会输出临时root密码，复制保存好，后续使用需要。

  MacOS执行：brew install mysql@8.0 && brew services start mysql@8.0

  Ubuntu执行：sudo apt install mysql-server-8.0 && sudo systemctl start mysql

  验证：终端输入mysql --version输出版本为8.x即成功。

• Maven3.8（后端构建工具）+Node.js16（前端构建工具）

  Maven下载地址：https://archive.apache.org/dist/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.zip，解压后把解压目录的bin文件夹加入系统Path环境变量即可。

  Node.js16下载地址：https://nodejs.org/download/release/v16.20.2/node-v16.20.2-x64.msi，Windows默认下一步安装即可，环境变量自动配置。

  验证：终端输入mvn -v输出版本3.8.x，node -v输出版本16.x即成功。

二、拉取技术内测源码

打开终端，进入你要存放项目的目录，执行以下命令拉取神仙开会放出的《天迹OL》技术内测源码：

git clone https://gitee.com/shenxianmeeting/tianji-ol-internal-test.git
cd tianji-ol-internal-test

三、数据库初始化与配置修改

3.1 创建并导入数据库

终端登录MySQL，执行命令（按提示输入root密码）：

mysql -u root -p

登录后执行以下SQL创建数据库，直接复制完整执行：

CREATE DATABASE tianji_ol DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit;

回到项目根目录，执行以下命令导入初始化数据：

mysql -u root -p tianji_ol < ./sql/init.sql

3.2 修改项目数据库配置

打开项目目录下src/main/resources/application-dev.yml，直接替换为以下完整内容，把密码改成你自己的MySQL root密码即可：

```
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/tianji_ol?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 你的MySQLroot密码
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
server:
port: 8081
```

四、构建启动后端服务

如果Maven下载依赖慢，打开本地Maven安装目录的conf/settings.xml，直接替换为以下配置，添加阿里云镜像加速：

```
<?xml version="1.0" encoding="UTF-8"?>



aliyunmaven

aliyun maven
https://maven.aliyun.com/repository/public



```

回到项目根目录，执行以下命令打包构建：

mvn clean package -DskipTests

构建完成后，执行对应命令启动后端：

 Mac/Linux用户用这个命令
nohup java -jar target/tianji-ol-1.0.0.jar & > /dev/null
 Windows用户用这个命令
java -jar target\tianji-ol-1.0.0.jar

五、构建启动前端服务

进入项目的web前端目录，执行依赖安装，用淘宝镜像加速，直接复制执行：

cd web
npm install --registry=https://registry.npmmirror.com

依赖安装完成后，执行启动命令：

npm run dev

启动完成后，打开浏览器访问：http://localhost:8080，即可进入《天迹OL》技术内测游戏界面。

六、默认测试账号&常见问题解决

• 游客测试账号：test，密码：123456
• 管理员后台账号：admin，密码：123456，后台地址：http://localhost:8080/admin
• 端口被占用解决：后端端口在application-dev.yml修改server.port为其他未占用端口，前端端口在web/vue.config.js修改devServer.port为其他端口。
• 依赖下载失败：确认使用了上文提供的加速镜像，切换稳定网络后重新执行安装命令即可。
• 数据库连接失败：检查MySQL服务是否启动，检查application-dev.yml中的用户名、密码、数据库名是否和本地配置一致。
• 源码拉取失败：检查网络连接，更换为国内镜像地址拉取即可。