docs(readme): 添加项目启动和编译问题解决方案文档
- 新增 FIX_COMPILE.md 文件,提供修复IDE编译问题的四种方法 - 新增 HOW_TO_START.md 文件,详细说明如何正确启动后端服务 - 强调必须启动 mt-pay 模块的 MtPayApplication 类 - 提供 IntelliJ IDEA 和 Maven 两种启动方式 - 列出常见启动错误及解决方案 - 添加快速检查清单帮助验证启动状态
This commit is contained in:
121
HOW_TO_START.md
Normal file
121
HOW_TO_START.md
Normal 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
|
||||
|
||||
Reference in New Issue
Block a user