Files
MTKJPAY/FIX_COMPILE.md
qiube 3133369053 docs(readme): 添加项目启动和编译问题解决方案文档
- 新增 FIX_COMPILE.md 文件,提供修复IDE编译问题的四种方法
- 新增 HOW_TO_START.md 文件,详细说明如何正确启动后端服务
- 强调必须启动 mt-pay 模块的 MtPayApplication 类
- 提供 IntelliJ IDEA 和 Maven 两种启动方式
- 列出常见启动错误及解决方案
- 添加快速检查清单帮助验证启动状态
2025-12-19 18:34:00 +08:00

109 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 修复编译问题指南
## 问题描述
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重新导入