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

65 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 启动后端服务
## ⚠️ 重要提示
**请启动 `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 模块)
4. 等待启动完成,看到以下日志表示启动成功:
```
╔══════════════════════════════════════════════════════════╗
║ ║
║ ✅ MTKJ PAY 支付系统启动成功! ✅ ║
║ ║
╠══════════════════════════════════════════════════════════╣
║ 应用名称: mt-pay ║
║ 运行环境: dev ║
║ 服务端口: 8082 ║
║ 后端服务: http://localhost:8082/ ║
║ API接口: http://localhost:8082/api ║
║ 状态: 🟢 服务运行中,可以接收请求 ║
╚══════════════════════════════════════════════════════════╝
```
### 方法2使用 Maven 命令启动
```bash
cd E:\MTKJPAY
mvn spring-boot:run
```
### 方法3打包后启动
```bash
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` 安装依赖