Files
MTKJPAY/START_BACKEND.md
qiube 84f74861bb feat(database): 初始化客户订单表结构
- 创建 customer_order 表,包含订单基本信息、客户信息、收货地址、支付信息等字段
- 设置订单状态和支付状态的默认值及注释说明
- 添加索引以优化查询性能,包括订单号、商品ID、状态和创建时间
- 指定表的存储引擎为 InnoDB,字符集为 utf8mb4

feat(common): 新增SKU状态枚举类

- 定义 SkuStatus 枚举,包含 ACTIVE 和 INACTIVE 两种状态
- 提供 getCode 和 getDescription 方法获取状态码和描述
- 实现 fromCode 静态方法用于根据状态码获取对应的枚举实例

docs(startup): 编写后端服务启动说明文档

- 添加启动后端服务的详细步骤和注意事项
- 说明正确的启动类位置及如何验证启动是否成功
- 提供常见问题诊断方法和解决方案
- 包含使用IDE、Maven命令和打包后的启动方式

feat(util): 新增字符串工具类

- 实现 isEmpty、isNotEmpty、isBlank、isNotBlank 等判断方法
- 提供 trim 方法去除字符串两端空白
- 添加 defaultIfEmpty 方法在字符串为空时返回默认值

docs(architecture): 编写系统架构完整性说明文档

- 描述后端和前端的完整架构组成及检查清单
- 说明系统的统一规范、代码复用、可扩展性和可维护性特点
- 展示包结构总览和最佳实践建议
- 对系统完整性进行评分并给出总结评价

docs(troubleshooting): 编写后端启动问题排查指南

- 针对前端无法连接后端的问题提供详细的排查流程
- 介绍多种启动后端服务的方法及常见失败原因
- 提供快速诊断命令和日志检查建议
- 列出需要提供的错误信息以便进一步协助

feat(config): 新增Web配置类支持跨域访问

- 配置 CORS 跨域资源共享规则,允许所有来源访问 /api/** 路径
- 设置允许的请求方法、请求头和凭证信息
- 添加日志记录跨域配置的过程和结果
2025-12-22 18:13:33 +08:00

2.6 KiB
Raw Blame History

启动后端服务

⚠️ 重要提示

请启动 mt-startup 模块的 MtkjpayApplication,这是项目的唯一启动类!

  • 正确:com.mtkj.mtkjpay.MtkjpayApplication (mt-startup 模块,唯一启动类)
  • 启动类位置:MTKJPAY/mt-startup/src/main/java/com/mtkj/mtkjpay/MtkjpayApplication.java

问题诊断

如果前端出现 connect ECONNREFUSED ::1:8082 错误,说明后端服务没有启动。

启动步骤

方法1使用 IDE 启动(推荐)

  1. 打开根目录项目 MTKJPAY
  2. 找到 mt-startup/src/main/java/com/mtkj/mtkjpay/MtkjpayApplication.java 文件
  3. 右键点击文件,选择 "Run 'MtkjpayApplication.main()'"
  4. 确认启动的是 com.mtkj.mtkjpay.MtkjpayApplication(来自 mt-startup 模块)
  5. 等待启动完成,看到以下日志表示启动成功:
    ╔══════════════════════════════════════════════════════════╗
    ║                                                          ║
    ║          ✅  MTKJ PAY 支付系统启动成功!  ✅             ║
    ║                                                          ║
    ╠══════════════════════════════════════════════════════════╣
    ║  应用名称: mt-pay                                         ║
    ║  运行环境: dev                                            ║
    ║  服务端口: 8082                                           ║
    ║  后端服务: http://localhost:8082/                        ║
    ║  API接口:  http://localhost:8082/api                     ║
    ║  状态: 🟢 服务运行中,可以接收请求                      ║
    ╚══════════════════════════════════════════════════════════╝
    

方法2使用 Maven 命令启动

cd E:\MTKJPAY
mvn spring-boot:run

方法3打包后启动

cd E:\MTKJPAY
mvn clean package
java -jar target/MTKJPAY-0.0.1-SNAPSHOT.jar

验证后端是否启动

在浏览器访问:http://localhost:8082/api/product/1

如果返回 JSON 响应,说明后端已启动成功。

常见问题

  1. 端口被占用:检查 8082 端口是否被其他程序占用
  2. 数据库连接失败:检查 application-dev.yml 中的数据库配置
  3. 依赖缺失:运行 mvn clean install 安装依赖