feat(dev): 添加开发环境支付配置和优惠券字段修复功能

- 新增开发环境控制器和环境感知支付服务
- 添加数据库字段缺失修复指南
- 改进优惠券适用商品查询逻辑
-优化支付配置获取方式
This commit is contained in:
2025-08-15 02:47:02 +08:00
parent b2e0aa9f28
commit fa83ef5967
14 changed files with 1535 additions and 13 deletions

View File

@@ -0,0 +1,190 @@
# 数据库字段缺失问题修复指南
## 🐛 问题描述
错误信息:
```
java.sql.SQLSyntaxErrorException: Unknown column 'goods_id' in 'field list'
```
**原因**: 数据库表 `shop_coupon_apply_item` 中缺少 `goods_id``category_id` 字段,但代码中尝试查询这些字段。
## 🔧 解决方案
### 方案一:执行数据库修复脚本(推荐)
1. **备份数据库**(重要!)
```bash
mysqldump -u username -p database_name > backup_$(date +%Y%m%d_%H%M%S).sql
```
2. **执行修复脚本**
```bash
mysql -u username -p database_name < src/main/resources/sql/simple_fix_coupon_table.sql
```
或者手动执行以下SQL
```sql
-- 添加缺失的字段
ALTER TABLE shop_coupon_apply_item
ADD COLUMN goods_id INT(11) NULL COMMENT '商品ID' AFTER coupon_id;
ALTER TABLE shop_coupon_apply_item
ADD COLUMN category_id INT(11) NULL COMMENT '分类ID' AFTER goods_id;
-- 添加索引
CREATE INDEX idx_coupon_apply_item_goods ON shop_coupon_apply_item(coupon_id, goods_id);
CREATE INDEX idx_coupon_apply_item_category ON shop_coupon_apply_item(coupon_id, category_id);
CREATE INDEX idx_coupon_apply_item_type ON shop_coupon_apply_item(coupon_id, type);
-- 检查表结构
DESCRIBE shop_coupon_apply_item;
```
### 方案二:临时代码修复(已实施)
我已经修改了 `CouponStatusServiceImpl.java` 中的代码,添加了异常处理:
```java
try {
// 尝试查询 goods_id 字段
List<ShopCouponApplyItem> applyItems = shopCouponApplyItemService.list(...);
// 处理逻辑
} catch (Exception e) {
log.warn("查询优惠券适用商品失败,可能是数据库字段不存在: {}", e.getMessage());
// 如果查询失败默认返回true允许使用
return true;
}
```
## 📋 修复步骤
### 1. 立即修复(临时方案)
- ✅ 已修改代码添加异常处理
- ✅ 使用 `pk` 字段作为临时的商品ID
- ✅ 查询失败时默认允许使用优惠券
### 2. 完整修复(推荐执行)
#### 步骤1停止应用
```bash
# 如果使用Docker
docker-compose down
# 或者直接停止Java进程
pkill -f java
```
#### 步骤2备份数据库
```bash
mysqldump -u root -p your_database > backup_$(date +%Y%m%d_%H%M%S).sql
```
#### 步骤3执行数据库修复
```bash
mysql -u root -p your_database < src/main/resources/sql/simple_fix_coupon_table.sql
```
#### 步骤4验证修复
```sql
-- 检查表结构
DESCRIBE shop_coupon_apply_item;
-- 应该看到以下字段:
-- id, coupon_id, goods_id, category_id, type, pk, status, deleted, tenant_id, create_time, update_time
```
#### 步骤5重启应用
```bash
# 如果使用Docker
docker-compose up -d
# 或者直接启动
java -jar your-app.jar
```
## 🧪 测试验证
### 1. 检查API接口
```bash
# 测试优惠券列表查询
curl -X GET "http://localhost:9200/api/shop/user-coupon/my/available"
# 测试优惠券验证
curl -X POST "http://localhost:9200/api/shop/coupon-status/validate" \
-H "Content-Type: application/json" \
-d '{"userCouponId":1,"totalAmount":150.00,"goodsIds":[1,2,3]}'
```
### 2. 检查日志
```bash
# 查看应用日志
tail -f logs/application.log
# 查找相关错误
grep -i "goods_id\|SQLSyntaxErrorException" logs/application.log
```
## 📊 数据迁移(可选)
如果表中已有数据,可能需要迁移:
```sql
-- 如果原来使用 pk 字段存储商品ID
UPDATE shop_coupon_apply_item
SET goods_id = pk
WHERE type = 1 AND pk IS NOT NULL AND goods_id IS NULL;
-- 如果原来使用其他字段存储分类ID
-- UPDATE shop_coupon_apply_item
-- SET category_id = some_other_field
-- WHERE type = 2 AND some_other_field IS NOT NULL AND category_id IS NULL;
```
## 🚨 注意事项
1. **数据备份**: 执行任何数据库修改前必须备份
2. **停机时间**: 建议在低峰期执行修复
3. **测试环境**: 先在测试环境验证修复效果
4. **回滚计划**: 准备回滚方案以防出现问题
## 🔄 回滚方案
如果修复后出现问题,可以回滚:
```sql
-- 删除新添加的字段
ALTER TABLE shop_coupon_apply_item DROP COLUMN goods_id;
ALTER TABLE shop_coupon_apply_item DROP COLUMN category_id;
-- 删除新添加的索引
DROP INDEX idx_coupon_apply_item_goods ON shop_coupon_apply_item;
DROP INDEX idx_coupon_apply_item_category ON shop_coupon_apply_item;
DROP INDEX idx_coupon_apply_item_type ON shop_coupon_apply_item;
```
或者直接恢复备份:
```bash
mysql -u root -p your_database < backup_20250115_143000.sql
```
## ✅ 修复完成检查清单
- [ ] 数据库已备份
- [ ] 执行了字段添加脚本
- [ ] 验证了表结构正确
- [ ] 重启了应用
- [ ] 测试了API接口正常
- [ ] 检查了应用日志无错误
- [ ] 验证了优惠券功能正常
## 📞 技术支持
如果在修复过程中遇到问题,请:
1. 检查数据库连接和权限
2. 确认SQL语法与MySQL版本兼容
3. 查看详细的错误日志
4. 如有必要,联系技术支持团队
修复完成后,优惠券状态管理功能应该可以正常使用!

View File

@@ -0,0 +1,212 @@
# 支付环境隔离解决方案
## 🎯 问题描述
**现状问题**
- 开发调试时需要修改支付回调地址为本地地址
- 修改后影响线上生产环境的正常使用
- 缺乏开发和生产环境的有效隔离机制
## 💡 解决方案概览
我为您提供了5种解决方案可以单独使用或组合使用
### 方案一:创建开发专用租户(推荐)✨
- 创建独立的开发租户ID: 9999
- 配置专用的支付参数和回调地址
- 完全隔离开发和生产环境
### 方案二:环境感知的支付配置服务
- 根据 `spring.profiles.active` 自动切换回调地址
- 开发环境自动使用本地回调,生产环境使用线上回调
- 无需手动修改配置
### 方案三:配置文件环境隔离
- 在配置文件中定义不同环境的回调地址
- 支持灵活的环境配置管理
### 方案四:开发环境管理工具
- 提供专用的开发环境管理接口
- 支持一键切换和恢复回调地址
- 仅在开发环境启用
### 方案五:多租户配置隔离
- 利用现有的多租户架构
- 为不同租户配置不同的支付参数
## 🚀 快速实施指南
### 步骤1执行数据库脚本推荐
```bash
# 创建开发专用租户和配置
mysql -u root -p your_database < src/main/resources/sql/create_dev_tenant_payment.sql
```
这将创建:
- 开发专用租户ID: 9999
- 开发环境支付配置(使用本地回调地址)
- 开发测试用户
### 步骤2配置环境感知服务
已创建的服务会自动:
- 检测当前运行环境
- 根据环境自动调整回调地址
- 开发环境:`http://frps-10550.s209.websoft.top/api/shop/shop-order/notify`
- 生产环境:`https://cms-api.websoft.top/api/shop/shop-order/notify`
### 步骤3使用开发环境管理工具
开发环境下可以访问以下接口:
```bash
# 查看环境信息
GET /api/dev/environment/info
# 查看支付配置
GET /api/dev/payment/config/0
# 切换回调地址
POST /api/dev/payment/switch-notify-url
{
"notifyUrl": "http://your-local-address/api/shop/shop-order/notify",
"payType": "0"
}
# 重置为生产环境
POST /api/dev/payment/reset-to-prod?payType=0
# 获取使用指南
GET /api/dev/guide
```
## 📋 使用方式对比
| 方案 | 优点 | 缺点 | 适用场景 |
|------|------|------|----------|
| 开发专用租户 | 完全隔离,不影响生产 | 需要创建额外数据 | 团队开发,长期使用 |
| 环境感知服务 | 自动切换,无需手动操作 | 需要代码改动 | 自动化程度高的项目 |
| 配置文件隔离 | 配置灵活,易于管理 | 需要重启应用 | 配置驱动的项目 |
| 开发管理工具 | 操作简单,功能丰富 | 仅开发环境可用 | 频繁调试的场景 |
| 多租户隔离 | 利用现有架构 | 依赖租户体系 | 已有多租户的系统 |
## 🔧 配置示例
### 开发环境配置 (application-dev.yml)
```yaml
payment:
dev:
notify-url: "http://frps-10550.s209.websoft.top/api/shop/shop-order/notify"
environment-aware: true
```
### 生产环境配置 (application-prod.yml)
```yaml
payment:
prod:
notify-url: "https://cms-api.websoft.top/api/shop/shop-order/notify"
environment-aware: false
```
## 🧪 测试验证
### 1. 验证环境感知功能
```bash
# 检查当前环境
curl -X GET "http://localhost:9200/api/dev/environment/info"
# 检查支付配置
curl -X GET "http://localhost:9200/api/dev/payment/config/0"
```
### 2. 验证回调地址切换
```bash
# 切换到本地回调
curl -X POST "http://localhost:9200/api/dev/payment/switch-notify-url" \
-H "Content-Type: application/json" \
-d '{"notifyUrl":"http://localhost:8080/api/shop/shop-order/notify","payType":"0"}'
# 重置为生产回调
curl -X POST "http://localhost:9200/api/dev/payment/reset-to-prod?payType=0"
```
## 🎨 最佳实践建议
### 推荐组合方案
**方案A完全隔离推荐**
1. 创建开发专用租户
2. 配置开发环境支付参数
3. 使用开发租户进行所有测试
**方案B自动化切换**
1. 部署环境感知服务
2. 配置环境相关参数
3. 代码自动根据环境切换
**方案C手动管理**
1. 使用开发环境管理工具
2. 调试时切换回调地址
3. 完成后恢复生产配置
### 开发流程建议
1. **开发阶段**:使用开发租户或本地回调地址
2. **测试阶段**:使用测试环境配置
3. **上线前**:确认生产环境配置正确
4. **上线后**:验证生产环境支付功能
## 🚨 注意事项
### 安全考虑
- 开发环境管理接口仅在开发环境启用
- 生产环境不会加载开发相关的控制器
- 敏感配置信息需要妥善保护
### 数据一致性
- 开发租户数据与生产数据隔离
- 定期清理开发环境测试数据
- 避免开发数据污染生产环境
### 团队协作
- 统一开发环境配置标准
- 文档化配置变更流程
- 建立配置变更审核机制
## 🔄 回滚方案
如果需要回滚到原有方式:
```sql
-- 删除开发租户(可选)
DELETE FROM sys_tenant WHERE tenant_id = 9999;
DELETE FROM sys_payment WHERE tenant_id = 9999;
DELETE FROM sys_user WHERE tenant_id = 9999;
-- 恢复原有支付配置
UPDATE sys_payment
SET notify_url = 'https://cms-api.websoft.top/api/shop/shop-order/notify'
WHERE tenant_id = 1;
```
## ✅ 实施检查清单
- [ ] 执行了数据库脚本创建开发租户
- [ ] 配置了环境感知服务
- [ ] 测试了开发环境管理接口
- [ ] 验证了自动环境切换功能
- [ ] 确认了生产环境配置正确
- [ ] 建立了开发流程规范
- [ ] 培训了团队成员使用方法
## 📞 技术支持
如果在实施过程中遇到问题:
1. 检查日志中的环境检测信息
2. 验证配置文件中的环境参数
3. 确认数据库中的租户和支付配置
4. 测试开发环境管理接口功能
实施完成后,您就可以在不影响生产环境的情况下进行支付功能的开发和调试了!

View File

@@ -0,0 +1,176 @@
# 生产环境安全配置指南
## 🚨 重要警告
**原始的 `create_dev_tenant_payment.sql` 脚本不要在生产数据库执行!**
该脚本包含测试数据,可能会影响生产环境。
## ✅ 安全的生产环境配置方案
### 方案一:使用后台管理界面(推荐)
1. **登录后台管理系统**
2. **进入支付配置页面**
3. **创建新的支付配置**
- 名称:`微信支付-开发环境`
- 类型:微信支付
- 回调地址:`http://frps-10550.s209.websoft.top/api/shop/shop-order/notify`
- 其他参数:复制现有生产配置
### 方案二使用API接口
```bash
# 1. 获取当前配置
curl -X GET "https://your-domain.com/api/payment/list" \
-H "Authorization: Bearer YOUR_TOKEN"
# 2. 创建开发配置
curl -X POST "https://your-domain.com/api/payment" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"name": "微信支付-开发环境",
"type": 0,
"appId": "YOUR_DEV_APP_ID",
"mchId": "YOUR_DEV_MCH_ID",
"notifyUrl": "http://frps-10550.s209.websoft.top/api/shop/shop-order/notify",
"environment": "dev"
}'
```
### 方案三执行安全的SQL脚本
如果必须使用SQL请使用我刚创建的安全版本
```bash
# 1. 先备份数据库
mysqldump -u root -p your_database > backup_$(date +%Y%m%d_%H%M%S).sql
# 2. 执行安全脚本
mysql -u root -p your_database < src/main/resources/sql/production_safe_payment_config.sql
# 3. 根据脚本输出的模板,手动创建开发配置
```
## 🔧 推荐的实施步骤
### 步骤1备份现有配置
```sql
-- 备份当前支付配置
CREATE TABLE sys_payment_backup_$(date +%Y%m%d) AS
SELECT * FROM sys_payment WHERE status = 1;
```
### 步骤2查看当前配置
```sql
-- 查看现有支付配置
SELECT id, name, type, notify_url, tenant_id
FROM sys_payment
WHERE status = 1 AND deleted = 0;
```
### 步骤3创建开发配置
**选择以下方式之一**
#### 方式A通过后台界面
1. 复制现有生产配置
2. 修改名称为"开发环境"
3. 修改回调地址为本地地址
#### 方式B通过SQL谨慎使用
```sql
-- 基于现有配置创建开发版本
INSERT INTO sys_payment (
name, type, code, app_id, mch_id, api_key,
notify_url, tenant_id, status, deleted, create_time, update_time
)
SELECT
CONCAT(name, '-开发环境'),
type,
CONCAT(code, '_dev'),
app_id,
mch_id,
api_key,
'http://frps-10550.s209.websoft.top/api/shop/shop-order/notify',
tenant_id,
0, -- 先设为禁用状态
0,
NOW(),
NOW()
FROM sys_payment
WHERE type = 0 AND status = 1 AND deleted = 0
LIMIT 1;
```
### 步骤4测试和验证
```bash
# 测试开发环境配置
curl -X GET "http://localhost:9200/api/dev/payment/config/0"
# 验证回调地址
curl -X POST "http://frps-10550.s209.websoft.top/api/shop/shop-order/notify" \
-d "test=1"
```
## 🛡️ 安全检查清单
- [ ] 已备份生产数据库
- [ ] 确认当前数据库环境
- [ ] 使用安全的配置方法
- [ ] 测试开发配置不影响生产
- [ ] 验证回调地址可访问
- [ ] 建立配置恢复机制
## 🔄 快速切换方案
### 开发时切换到本地回调
```sql
-- 临时修改(记录原始值)
UPDATE sys_payment
SET notify_url = 'http://frps-10550.s209.websoft.top/api/shop/shop-order/notify'
WHERE id = YOUR_PAYMENT_CONFIG_ID;
```
### 完成后恢复生产回调
```sql
-- 恢复生产配置
UPDATE sys_payment
SET notify_url = 'https://cms-api.websoft.top/api/shop/shop-order/notify'
WHERE id = YOUR_PAYMENT_CONFIG_ID;
```
## 🚀 最佳实践
1. **使用环境感知服务**:让代码自动根据环境切换
2. **创建专用开发配置**:避免修改生产配置
3. **使用配置管理工具**通过界面而非SQL操作
4. **建立回滚机制**:确保可以快速恢复
5. **团队协作规范**:统一配置管理流程
## ❌ 避免的操作
- ❌ 直接在生产库执行包含测试数据的脚本
- ❌ 修改生产配置进行开发调试
- ❌ 在生产环境创建测试租户
- ❌ 不备份就修改重要配置
- ❌ 忘记恢复生产环境配置
## 📞 如果出现问题
1. **立即停止操作**
2. **检查数据库备份**
3. **恢复原始配置**
```sql
-- 从备份恢复
INSERT INTO sys_payment SELECT * FROM sys_payment_backup_YYYYMMDD;
```
4. **联系技术支持**
记住:**安全第一,谨慎操作!** 🛡️