DOPJAVA/QUICK_START_GUIDE.md

快速启动指南

后端启动

方式一：直接运行 JAR 包（推荐）

# 1. 清理并打包
cd yudao-server
mvn clean package -DskipTests

# 2. 启动服务
java -jar target/yudao-server.jar --spring.profiles.active=local

方式二：使用 Maven 插件

cd yudao-server
mvn spring-boot:run "-Dspring-boot.run.profiles=local"

常见问题

问题1：XML 解析错误

Caused by: org.xml.sax.SAXParseException: 元素内容必须由格式正确的字符数据或标记组成

解决方案：清理 target 目录后重新编译

# 清理所有模块的 target 目录
mvn clean

# 或者手动删除
rm -rf yudao-module-*/target
rm -rf yudao-server/target

# 重新打包
cd yudao-server
mvn clean package -DskipTests

问题2：Bean 冲突

The bean 'xxx' could not be registered. A bean with that name has already been defined

解决方案：

1. 检查是否有重复的 Bean 定义
2. 删除重复的配置类
3. 参考 BEAN_CONFLICT_FIX.md

问题3：Mapper 冲突

Annotation-specified bean name 'xxxMapper' conflicts with existing

解决方案：

1. 重命名 Mapper 接口
2. 更新对应的 XML 文件
3. 参考 MAPPER_CONFLICT_FIX.md

问题4：TypeAlias 冲突

MyBatis TypeAlias conflict

解决方案：

1. 重命名 DO 类
2. 更新所有引用
3. 清理 target 目录
4. 参考 TYPEALIAS_CONFLICT_FIX.md

前端启动

cd yudao-ui/yudao-ui-admin-vue3

# 安装依赖（首次运行）
pnpm install

# 启动开发服务器
pnpm dev

访问地址：http://localhost:80

验证服务

后端服务

• API 地址：http://localhost:48080
• API 文档：http://localhost:48080/doc.html
• Druid 监控：http://localhost:48080/druid

前端服务

• 管理后台：http://localhost:80

完整重启流程

当遇到问题需要完全重启时：

# 1. 停止所有服务
# 按 Ctrl+C 停止前后端服务

# 2. 清理编译文件
mvn clean

# 3. 重新编译后端
cd yudao-server
mvn clean package -DskipTests

# 4. 启动后端
java -jar target/yudao-server.jar --spring.profiles.active=local

# 5. 启动前端（新终端）
cd yudao-ui/yudao-ui-admin-vue3
pnpm dev

开发建议

1. 修改代码后：

   • Java 代码修改：需要重启后端
   • Vue 代码修改：热更新自动生效
   • XML 文件修改：需要重启后端

2. 修改 DO 类后：

   • 必须清理 target 目录
   • 重新编译整个项目
   • 避免使用 mvn install，优先使用 mvn clean package

3. 添加新模块后：

   • 更新根 pom.xml
   • 更新 yudao-server/pom.xml
   • 清理并重新编译

4. 数据库变更后：

   • 更新 SQL 脚本
   • 更新对应的 DO 类
   • 更新 Mapper XML

日期

2026-02-04