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

121
HOW_TO_START.md Normal file
View File

@@ -0,0 +1,121 @@
# 如何正确启动后端服务
## ⚠️ 重要:启动正确的模块
项目有两个启动类,**必须启动 `mt-pay` 模块的启动类**
### ✅ 正确的启动类
- **类名**`com.mtkj.mtpay.MtPayApplication`
- **位置**`MTKJPAY/mt-pay/src/main/java/com/mtkj/mtpay/MtPayApplication.java`
- **端口**8082
- **包含**:所有业务代码、控制器、服务等
### ❌ 错误的启动类(不要启动这个!)
- **类名**`com.mtkj.mtkjpay.MtkjpayApplication`
- **位置**`MTKJPAY/src/main/java/com/mtkj/mtkjpay/MtkjpayApplication.java`
- **端口**8080
- **包含**:仅占位代码,无业务功能
## 在 IntelliJ IDEA 中启动
### 步骤1确认项目结构
确保在 Project 视图中能看到 `mt-pay` 模块:
```
MTKJPAY
├── mt-pay ← 这个模块
│ └── src
│ └── main
│ └── java
│ └── com
│ └── mtkj
│ └── mtpay
│ └── MtPayApplication.java ← 启动这个
└── src ← 根目录(不要启动这个)
└── main
└── java
└── com
└── mtkj
└── mtkjpay
└── MtkjpayApplication.java ← 不要启动这个
```
### 步骤2打开正确的启动类
1. 在 Project 视图中,导航到:
`MTKJPAY``mt-pay``src``main``java``com``mtkj``mtpay``MtPayApplication.java`
2. 双击打开 `MtPayApplication.java`
### 步骤3运行启动类
1. 右键点击 `MtPayApplication.java` 文件
2. 选择 **"Run 'MtPayApplication.main()'"**
3. 或者点击类名旁边的绿色运行按钮
### 步骤4确认启动成功
启动成功后,控制台会显示:
```
╔══════════════════════════════════════════════════════════╗
║ ║
║ ✅ MTKJ PAY 支付系统启动成功! ✅ ║
║ ║
╠══════════════════════════════════════════════════════════╣
║ 应用名称: mt-pay ║
║ 运行环境: dev ║
║ 服务端口: 8082 ║
║ 后端服务: http://localhost:8082/ ║
║ API接口: http://localhost:8082/api ║
║ 状态: 🟢 服务运行中,可以接收请求 ║
╚══════════════════════════════════════════════════════════╝
```
## 使用 Maven 命令启动
```bash
# 进入 mt-pay 模块目录
cd E:\MTKJPAY\mt-pay
# 启动应用
mvn spring-boot:run
```
## 验证启动成功
1. **检查端口**
```bash
netstat -ano | findstr :8082
```
应该能看到端口 8082 在监听
2. **访问接口**
在浏览器访问http://localhost:8082/api/product/1
如果返回 JSON 响应,说明启动成功
3. **查看日志**
控制台应该显示启动成功的标识框
## 常见错误
### 错误1启动的是根目录的 Application
- **症状**:端口是 8080没有业务功能
- **解决**:确保启动的是 `mt-pay` 模块的 `MtPayApplication`
### 错误2找不到启动类
- **症状**IDE 中找不到 `MtPayApplication`
- **解决**
1. 确认 `mt-pay` 模块已正确导入
2. 刷新 Maven 项目:右键项目 → Maven → Reload Project
3. 重新构建项目Build → Rebuild Project
### 错误3端口被占用
- **症状**:启动失败,提示端口 8082 被占用
- **解决**
1. 查找占用进程:`netstat -ano | findstr :8082`
2. 结束进程或修改端口配置
## 快速检查清单
- [ ] 启动的是 `com.mtkj.mtpay.MtPayApplication`
- [ ] 不是 `com.mtkj.mtkjpay.MtkjpayApplication`
- [ ] 端口是 8082不是 8080
- [ ] 看到启动成功的标识框
- [ ] 可以访问 http://localhost:8082/api/product/1