hzdyjs/backend/🔧编译错误修复指南.md

🔧 编译错误修复指南

❌ 错误现象

运行 mvn spring-boot:run 启动应用时报错：

Caused by: java.io.FileNotFoundException: class path resource [org/dromara/hq/service/IHqHallReservationService.class] cannot be opened because it does not exist

🔍 问题分析

根本原因

使用 mvn spring-boot:run 启动应用时，Maven会从本地仓库加载依赖的jar包，而不是直接使用项目中的target目录。

问题模块

• ruoyi-hq 模块虽然编译成功（target目录中有class文件），但没有被安装到本地Maven仓库
• ruoyi-admin 运行时无法找到 ruoyi-hq 模块中的类

✅ 解决方案

方案一：重新安装 ruoyi-hq 模块（推荐）

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend

# 1. 清理并重新编译安装 ruoyi-hq 模块
mvn clean install -pl ruoyi-modules/ruoyi-hq -am -DskipTests

# 2. 验证安装成功
ls ~/.m2/repository/org/dromara/ruoyi-hq/5.4.0/

# 3. 重新启动应用
cd ruoyi-admin
mvn spring-boot:run

方案二：使用jar包启动（更稳定）

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend

# 1. 重新打包 admin 模块
mvn clean package -pl ruoyi-admin -am -DskipTests

# 2. 使用jar包启动
java -jar ruoyi-admin/target/ruoyi-admin.jar

方案三：完整重新编译（最彻底）

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend

# 1. 清理所有编译产物
mvn clean

# 2. 重新编译并安装所有模块
mvn install -DskipTests

# 3. 启动应用
cd ruoyi-admin
mvn spring-boot:run

🎯 推荐步骤

第一步：尝试方案一

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend
mvn clean install -pl ruoyi-modules/ruoyi-hq -am -DskipTests
cd ruoyi-admin
mvn spring-boot:run

如果方案一失败，使用方案二

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend
mvn clean package -pl ruoyi-admin -am -DskipTests
java -jar ruoyi-admin/target/ruoyi-admin.jar

📋 验证清单

• ruoyi-hq 模块编译成功
• ruoyi-hq jar包存在于本地Maven仓库：~/.m2/repository/org/dromara/ruoyi-hq/5.4.0/ruoyi-hq-5.4.0.jar
• ruoyi-admin 启动时不再报 FileNotFoundException
• 应用成功启动并显示Spring Boot启动信息

🔄 后续预防

每次修改代码后的标准流程

1. 修改单个模块后：

   # 假设修改了 ruoyi-hq 模块
   mvn clean install -pl ruoyi-modules/ruoyi-hq -DskipTests
   

2. 修改多个模块后：

   # 重新安装所有依赖模块
   mvn clean install -pl ruoyi-modules/ruoyi-hq,ruoyi-modules/ruoyi-rs -DskipTests
   

3. 启动应用：

   cd ruoyi-admin
   mvn spring-boot:run
   # 或使用jar包
   java -jar target/ruoyi-admin.jar
   

💡 关键理解

启动方式	依赖来源	优点	缺点
mvn spring-boot:run	本地Maven仓库	开发时热重载	需要先install依赖模块
java -jar	jar包内嵌	独立运行，无需Maven	修改代码需重新打包

🚀 下一步

执行以下命令解决当前问题：

cd /Users/weizzzz/Documents/Cursor/0828CURSOR/all-project/backend
mvn clean install -pl ruoyi-modules/ruoyi-hq -am -DskipTests
cd ruoyi-admin
mvn spring-boot:run

---

文档生成时间: 2025-10-14 01:55 适用版本: RuoYi-Vue-Plus 5.4.0