Order Center 电商订单中心 API（JWT + 幂等 + 支付回调）

技术信息

语言技术
Java、Docker、JPA、Spring、MySQL系统类型
Web行业分类
电商

作品详情

行业场景

面向小程序商城、私域电商、社区团购等中小电商场景，承接前端下单、库存扣减、支付回调与订单查询。这类业务日订单量从几千到十万级，流量集中在活动开抢的几分钟内，对下单幂等、库存一致性、支付回调可靠性要求很高，通常需要对接微信支付、支付宝等渠道并支持日常对账。

功能介绍

面向电商/小程序场景的订单中心后端服务，重点解决下单幂等、库存并发与支付回调三个高频问题。

核心模块：
1. 认证授权：注册、登录，JWT（HS256）无状态鉴权，BCrypt 密码存储；用户只能访问自己的订单，发货/完成等操作限管理员角色。
2. 商品与库存：商品分页查询；下单时通过条件更新（stock >= qty 才扣减）保证不超卖，受影响行数为 0 即返回 409。
3. 幂等下单：支持 Idempotency-Key 请求头，配合 (user_id, idempotency_key) 唯一索引，重复提交返回同一订单，库存只扣一次。
4. 订单管理：多商品下单、订单列表（状态筛选 + 分页）、详情、取消（自动回补库存）。
5. 订单状态机：CREATED → PAID → SHIPPED → COMPLETED，CREATED → CANCELLED，非法流转返回 409。
6. 支付回调：HMAC-SHA256 验签（常量时间比较），trade_no 唯一保证重复回调只处理一次，金额与订单应付校验，异常状态返回 IGNORED。
7. 接口文档：集成 springdoc-openapi，Swagger UI 支持 Bearer Token 在线调试。
8. 工程化：统一错误响应体、全局异常处理、Actuator 健康检查、Docker 部署、17 个自动化测试。

项目实现

1. 接口设计与领域建模：订单、订单行、商品、支付流水及状态机
2. 认证授权：JWT 签发与校验、过滤器、角色权限控制
3. 下单主流程：库存条件扣减、幂等键、订单号生成、金额计算
4. 订单查询与取消：分页筛选、越权校验、取消回补库存
5. 支付回调：签名验证、重复回调幂等、金额与状态校验
6. 参数校验与统一异常响应、错误码设计
7. 接口文档：OpenAPI 注解、Swagger 联调
8. 测试：17 个用例 + 端到端脚本（下单→回调→重复回调）
9. 部署与文档：Dockerfile、systemd 服务、README
技术栈：Java 21、Spring Boot 3.5、Spring Security、JJWT 0.12、Spring Data JPA /
Hibernate、H2、MySQL 8、springdoc-openapi、JUnit 5 + MockMvc、Docker