mp-java/docs/PAYMENT_ENVIRONMENT_ISOLATION_GUIDE.md

支付环境隔离解决方案

🎯 问题描述

现状问题：

• 开发调试时需要修改支付回调地址为本地地址
• 修改后影响线上生产环境的正常使用
• 缺乏开发和生产环境的有效隔离机制

💡 解决方案概览

我为您提供了5种解决方案，可以单独使用或组合使用：

方案一：创建开发专用租户（推荐）✨

• 创建独立的开发租户（ID: 9999）
• 配置专用的支付参数和回调地址
• 完全隔离开发和生产环境

方案二：环境感知的支付配置服务

• 根据 spring.profiles.active 自动切换回调地址
• 开发环境自动使用本地回调，生产环境使用线上回调
• 无需手动修改配置

方案三：配置文件环境隔离

• 在配置文件中定义不同环境的回调地址
• 支持灵活的环境配置管理

方案四：开发环境管理工具

• 提供专用的开发环境管理接口
• 支持一键切换和恢复回调地址
• 仅在开发环境启用

方案五：多租户配置隔离

• 利用现有的多租户架构
• 为不同租户配置不同的支付参数

🚀 快速实施指南

步骤1：执行数据库脚本（推荐）

# 创建开发专用租户和配置
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：使用开发环境管理工具

开发环境下可以访问以下接口：

# 查看环境信息
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)

payment:
  dev:
    notify-url: "http://frps-10550.s209.websoft.top/api/shop/shop-order/notify"
    environment-aware: true

生产环境配置 (application-prod.yml)

payment:
  prod:
    notify-url: "https://cms-api.websoft.top/api/shop/shop-order/notify"
    environment-aware: false

🧪 测试验证

1. 验证环境感知功能

# 检查当前环境
curl -X GET "http://localhost:9200/api/dev/environment/info"

# 检查支付配置
curl -X GET "http://localhost:9200/api/dev/payment/config/0"

2. 验证回调地址切换

# 切换到本地回调
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. 上线后：验证生产环境支付功能

🚨 注意事项

安全考虑

• 开发环境管理接口仅在开发环境启用
• 生产环境不会加载开发相关的控制器
• 敏感配置信息需要妥善保护

数据一致性

• 开发租户数据与生产数据隔离
• 定期清理开发环境测试数据
• 避免开发数据污染生产环境

团队协作

• 统一开发环境配置标准
• 文档化配置变更流程
• 建立配置变更审核机制

🔄 回滚方案

如果需要回滚到原有方式：

-- 删除开发租户（可选）
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. 测试开发环境管理接口功能

实施完成后，您就可以在不影响生产环境的情况下进行支付功能的开发和调试了！