qiube
3133369053
- 新增 FIX_COMPILE.md 文件，提供修复IDE编译问题的四种方法 - 新增 HOW_TO_START.md 文件，详细说明如何正确启动后端服务 - 强调必须启动 mt-pay 模块的 MtPayApplication 类 - 提供 IntelliJ IDEA 和 Maven 两种启动方式 - 列出常见启动错误及解决方案 - 添加快速检查清单帮助验证启动状态
122 lines
4.4 KiB
Markdown
122 lines
4.4 KiB
Markdown
# 如何正确启动后端服务
|
||
|
||
## ⚠️ 重要：启动正确的模块
|
||
|
||
项目有两个启动类，**必须启动 `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
|
||
|