MTKJPAY/HOW_TO_START.md

如何正确启动后端服务

⚠️ 重要：启动正确的模块

项目有两个启动类，必须启动 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 命令启动

# 进入 mt-pay 模块目录
cd E:\MTKJPAY\mt-pay

# 启动应用
mvn spring-boot:run

验证启动成功

1. 检查端口：

   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