外观
启动与打包（ruoyi-aihuman-backend）
面向本地开发、打包与部署。后端入口模块
ruoyi-admin，端口 8088。后端仓库：
ruoyi-aihuman-backend（基于 RuoYi-Vue 的智能助手模块）。
一、启动方式
1.1 命令速查
powershell
# 进入项目根目录
cd e:\DaTa\data-pipe-gallery\data-digital-human-all\ruoyi-aihuman-backend
# 开发调试（两步）
mvn -DskipTests install
mvn -pl ruoyi-admin spring-boot:run
# 打包运行
mvn clean package -DskipTests
java -jar ruoyi-admin\target\dtgl-dhman.jar1.2 项目基本信息
| 项 | 值 |
|---|---|
| 构建工具 | Maven（多模块聚合，根 pom.xml） |
| JDK | 17 |
| Spring Boot | 2.5.15 |
| 入口模块 | ruoyi-admin（artifactId = dtgl-dhman） |
| 主类 | com.ruoyi.RuoYiApplication |
| HTTP 端口 | 8088 |
| 打包产物 | ruoyi-admin/target/dtgl-dhman.jar |
外部依赖
- Redis（必需）：
192.168.3.191:6379，database21。对话历史、配对状态、工具挂起状态全部存于 Redis。 - MySQL（不需要）：主类已
exclude = DataSourceAutoConfiguration，本项目不读写 MySQL。
1.3 启动前环境检查
powershell
java -version # 需为 17
mvn -v # 需为 Maven 3.x1.4 方式一：开发调试（推荐，等价 IDEA 绿色三角）
带 spring-boot-devtools 热重载，改代码自动重启，最适合日常开发。
powershell
cd e:\DaTa\data-pipe-gallery\data-digital-human-all\ruoyi-aihuman-backend
# 首次必做：构建并安装各子模块到本地仓库
mvn -DskipTests install
# 单独启动入口模块
mvn -pl ruoyi-admin spring-boot:run只改
ruoyi-admin下的代码则无需重跑install；修改了ruoyi-common、ruoyi-aihuman-*等子模块也要重新执行。
1.5 方式二：打包后运行 jar（部署 / 生产）
powershell
mvn clean package -DskipTests
java -jar ruoyi-admin\target\dtgl-dhman.jar后台运行
powershell
Start-Process java -ArgumentList '-jar','ruoyi-admin\target\dtgl-dhman.jar' `
-RedirectStandardOutput run.log -RedirectStandardError run-err.log -PassThru停止（按端口定位）：
powershell
netstat -ano | findstr :8088
taskkill /PID <进程号> /F1.6 启动成功判定
日志最后出现以下内容即表示启动成功：
Starting ProtocolHandler ["http-nio-8088"]
Started RuoYiApplication in x.xxx seconds (JVM running for x.xxx)
(♥◠‿◠)ﾉﾞ 若依启动成功 ლ(´ڡ`ლ)ﾞ浏览器访问：http://localhost:8088
1.7 临时覆盖配置
jar 方式
powershell
java -jar ruoyi-admin\target\dtgl-dhman.jar --server.port=9090 --spring.redis.host=127.0.0.1Maven 方式
powershell
mvn -pl ruoyi-admin spring-boot:run "-Dspring-boot.run.arguments=--server.port=9090"1.8 常见问题
| 问题 | 处理 |
|---|---|
报 No plugin found for prefix 'spring-boot' | 不要给 spring-boot:run 加 -am；先 mvn -DskipTests install，再 mvn -pl ruoyi-admin spring-boot:run |
mvn 找不到命令 | 本项目无 mvnw，需配置 MAVEN_HOME 与 PATH |
| 8088 端口被占用 | `netstat -ano |
| 启动正常但 AI 接口报错 | 优先检查 Redis（192.168.3.191:6379）是否可达密码是否正确 |
| 日志位置 | 项目根目录 logs/，配置见 ruoyi-admin/src/main/resources/logback.xml |
二、打包部署
powershell
# 在后端根目录执行（不要直接点击 IDEA 蓝色三角箭头）
mvn clean package -DskipTests产物：ruoyi-admin/target/dtgl-dhman.jar，使用 java -jar 运行即可（见上节方式二）。