docs(readme): 添加项目启动和编译问题解决方案文档

- 新增 FIX_COMPILE.md 文件,提供修复IDE编译问题的四种方法
- 新增 HOW_TO_START.md 文件,详细说明如何正确启动后端服务
- 强调必须启动 mt-pay 模块的 MtPayApplication 类
- 提供 IntelliJ IDEA 和 Maven 两种启动方式
- 列出常见启动错误及解决方案
- 添加快速检查清单帮助验证启动状态
This commit is contained in:
2025-12-19 18:34:00 +08:00
parent efa56da5b2
commit 3133369053
13 changed files with 1185 additions and 0 deletions

108
FIX_COMPILE.md Normal file
View File

@@ -0,0 +1,108 @@
# 修复编译问题指南
## 问题描述
IDE提示"Java file is located outside of the module source root, so it won't be compiled"
## 解决步骤
### 方法1在 IntelliJ IDEA 中重新导入项目(推荐)
1. **关闭项目**
- File → Close Project
2. **重新打开项目**
- File → Open
- 选择 `E:\MTKJPAY` 目录
- 选择 "Open as Project"
3. **等待 Maven 导入完成**
- 右下角会显示 "Importing Maven projects..."
- 等待完成
4. **刷新 Maven 项目**
- 右键根目录项目 → Maven → Reload Project
- 或者View → Tool Windows → Maven → 点击刷新按钮
5. **重新构建项目**
- Build → Rebuild Project
### 方法2手动配置 Source Root
1. **打开项目结构**
- File → Project Structure (Ctrl+Alt+Shift+S)
2. **检查 Modules**
- 左侧选择 "Modules"
- 确认有两个模块:
- `MTKJPAY` (根模块)
- `mt-pay` (子模块)
3. **配置 MTKJPAY 模块**
- 选择 `MTKJPAY` 模块
- 在 "Sources" 标签页
- 确认 `src/main/java` 标记为蓝色Source Folders
- 确认 `src/main/resources` 标记为绿色Resources Folders
- 如果没有标记,右键文件夹 → Mark Directory as → Sources Root / Resources Root
4. **配置 mt-pay 模块**
- 选择 `mt-pay` 模块
- 在 "Sources" 标签页
- 确认 `mt-pay/src/main/java` 标记为蓝色
- 确认 `mt-pay/src/main/resources` 标记为绿色
5. **应用并确定**
- 点击 "Apply" → "OK"
### 方法3使用 Maven 命令编译
```bash
# 进入项目根目录
cd E:\MTKJPAY
# 清理并编译
mvn clean compile
# 或者安装到本地仓库
mvn clean install
```
### 方法4检查 IDE 设置
1. **检查 Maven 设置**
- File → Settings → Build, Execution, Deployment → Build Tools → Maven
- 确认 "Maven home directory" 正确
- 确认 "User settings file" 正确
2. **检查 Java 设置**
- File → Settings → Build, Execution, Deployment → Compiler → Java Compiler
- 确认 "Project bytecode version" 是 17
3. **检查项目 SDK**
- File → Project Structure → Project
- 确认 "SDK" 是 Java 17
- 确认 "Language level" 是 17
## 验证修复
编译成功后:
1. 在 IDE 中Java 文件不应该有红色波浪线
2. 可以正常启动 `MtkjpayApplication`
3. 控制台没有编译错误
## 如果仍然有问题
1. **删除 .idea 文件夹**(需要关闭项目)
- 关闭 IntelliJ IDEA
- 删除 `E:\MTKJPAY\.idea` 文件夹
- 重新打开项目
2. **删除 target 文件夹**
```bash
cd E:\MTKJPAY
rmdir /s /q target
rmdir /s /q mt-pay\target
```
3. **重新导入项目**
- 按照方法1重新导入