# 快速启动指南

## 后端启动

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

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

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

### 方式二：使用 Maven 插件

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

### 常见问题

#### 问题1：XML 解析错误
```
Caused by: org.xml.sax.SAXParseException: 元素内容必须由格式正确的字符数据或标记组成
```

**解决方案**：清理 target 目录后重新编译
```bash
# 清理所有模块的 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`

## 前端启动

```bash
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`

## 完整重启流程

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

```bash
# 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