11

2025-09-06 11:58:18 +08:00
commit 8d34972119
1483 changed files with 141190 additions and 0 deletions
--- a/docs/微信小程序配置问题解决方案.md
+++ b/docs/微信小程序配置问题解决方案.md
@@ -0,0 +1,230 @@
+# 微信小程序配置问题解决方案
+
+## 🔍 问题分析
+
+### 错误信息
+```
+生成二维码失败: 租户 10550 的小程序未配置，请先在系统设置中配置微信小程序信息
+```
+
+### 问题根源
+代码在`SettingServiceImpl.getBySettingKeyIgnoreTenant`方法中查找微信小程序配置时，使用以下SQL条件：
+```sql
+SELECT * FROM sys_setting 
+WHERE setting_key = 'mp-weixin' 
+  AND tenant_id = 10550 
+  AND deleted = 0
+```
+
+但是你的配置存储在`cms_website_field`表中，字段结构为：
+- `name = 'AppID'` - 微信小程序AppID
+- `name = 'AppSecret'` - 微信小程序AppSecret
+- `tenant_id = 10550` - 租户ID
+
+## ✅ 解决方案
+
+我已经修改了`SettingServiceImpl`，让它在找不到`sys_setting`配置时，自动从`cms_website_field`表中读取配置。
+
+### 🔧 代码修改
+
+#### 1. 修改SettingServiceImpl
+在`getBySettingKeyIgnoreTenant`方法中添加了备用配置读取逻辑：
+
+```java
+if ("mp-weixin".equals(key)) {
+    // 尝试从cms_website_field表中读取微信小程序配置
+    JSONObject websiteFieldConfig = getWeixinConfigFromWebsiteField(tenantId);
+    if (websiteFieldConfig != null) {
+        System.out.println("从cms_website_field表获取到微信小程序配置: " + websiteFieldConfig);
+        return websiteFieldConfig;
+    }
+    throw new BusinessException("租户 " + tenantId + " 的小程序未配置，请先在系统设置中配置微信小程序信息");
+}
+```
+
+#### 2. 新增配置读取方法
+```java
+private JSONObject getWeixinConfigFromWebsiteField(Integer tenantId) {
+    // 查询AppID
+    CmsWebsiteField appIdField = cmsWebsiteFieldService.getOne(
+        new LambdaQueryWrapper<CmsWebsiteField>()
+            .eq(CmsWebsiteField::getName, "AppID")
+            .eq(CmsWebsiteField::getTenantId, tenantId)
+            .eq(CmsWebsiteField::getDeleted, 0)
+    );
+    
+    // 查询AppSecret
+    CmsWebsiteField appSecretField = cmsWebsiteFieldService.getOne(
+        new LambdaQueryWrapper<CmsWebsiteField>()
+            .eq(CmsWebsiteField::getName, "AppSecret")
+            .eq(CmsWebsiteField::getTenantId, tenantId)
+            .eq(CmsWebsiteField::getDeleted, 0)
+    );
+    
+    if (appIdField != null && appSecretField != null 
+        && appIdField.getValue() != null && !appIdField.getValue().trim().isEmpty()
+        && appSecretField.getValue() != null && !appSecretField.getValue().trim().isEmpty()) {
+        
+        // 构建微信小程序配置JSON
+        JSONObject config = new JSONObject();
+        config.put("appId", appIdField.getValue().trim());
+        config.put("appSecret", appSecretField.getValue().trim());
+        
+        return config;
+    }
+    
+    return null;
+}
+```
+
+## 📋 配置检查步骤
+
+### 1. 检查现有配置
+执行SQL查询检查你的配置：
+```sql
+SELECT id, name, value, tenant_id, deleted, comments
+FROM cms_website_field 
+WHERE tenant_id = 10550 
+  AND name IN ('AppID', 'AppSecret')
+  AND deleted = 0;
+```
+
+### 2. 创建配置（如果不存在）
+如果查询结果为空，需要创建配置：
+```sql
+-- 创建AppID配置
+INSERT INTO cms_website_field (type, name, value, tenant_id, comments, deleted, create_time) 
+VALUES (0, 'AppID', '你的微信小程序AppID', 10550, '微信小程序AppID', 0, NOW());
+
+-- 创建AppSecret配置
+INSERT INTO cms_website_field (type, name, value, tenant_id, comments, deleted, create_time) 
+VALUES (0, 'AppSecret', '你的微信小程序AppSecret', 10550, '微信小程序AppSecret', 0, NOW());
+```
+
+### 3. 更新配置值
+如果配置存在但值不正确，更新配置：
+```sql
+-- 更新AppID
+UPDATE cms_website_field 
+SET value = '你的实际AppID'
+WHERE name = 'AppID' AND tenant_id = 10550 AND deleted = 0;
+
+-- 更新AppSecret
+UPDATE cms_website_field 
+SET value = '你的实际AppSecret'
+WHERE name = 'AppSecret' AND tenant_id = 10550 AND deleted = 0;
+```
+
+## 🧪 测试验证
+
+### 1. 运行测试
+```bash
+# 运行配置测试
+mvn test -Dtest=WeixinConfigTest
+
+# 运行特定测试方法
+mvn test -Dtest=WeixinConfigTest#testGetWeixinConfigFromWebsiteField
+```
+
+### 2. 手动验证
+重启应用后，尝试生成二维码功能，应该不再报错。
+
+## 🔄 配置流程
+
+### 原始流程
+```
+请求微信小程序配置
+    ↓
+查询 sys_setting 表
+    ↓
+setting_key = 'mp-weixin' AND tenant_id = 10550
+    ↓
+未找到配置 → 抛出异常
+```
+
+### 修改后流程
+```
+请求微信小程序配置
+    ↓
+查询 sys_setting 表
+    ↓
+setting_key = 'mp-weixin' AND tenant_id = 10550
+    ↓
+未找到配置
+    ↓
+查询 cms_website_field 表
+    ↓
+name = 'AppID' AND name = 'AppSecret' AND tenant_id = 10550
+    ↓
+找到配置 → 构建JSON返回
+    ↓
+未找到配置 → 抛出异常
+```
+
+## 📊 配置格式对比
+
+### sys_setting表格式
+```json
+{
+  "setting_key": "mp-weixin",
+  "content": "{\"appId\":\"wx1234567890abcdef\",\"appSecret\":\"abcdef1234567890abcdef1234567890\"}",
+  "tenant_id": 10550
+}
+```
+
+### cms_website_field表格式
+```sql
+-- AppID记录
+name = 'AppID', value = 'wx1234567890abcdef', tenant_id = 10550
+
+-- AppSecret记录  
+name = 'AppSecret', value = 'abcdef1234567890abcdef1234567890', tenant_id = 10550
+```
+
+### 最终返回格式
+```json
+{
+  "appId": "wx1234567890abcdef",
+  "appSecret": "abcdef1234567890abcdef1234567890"
+}
+```
+
+## ⚠️ 注意事项
+
+### 1. 配置安全
+- AppSecret是敏感信息，确保数据库访问权限控制
+- 建议定期更换AppSecret
+
+### 2. 字段名称
+- 确保`cms_website_field`表中的`name`字段值准确：
+  - `AppID`（注意大小写）
+  - `AppSecret`（注意大小写）
+
+### 3. 租户隔离
+- 确保`tenant_id = 10550`
+- 确保`deleted = 0`
+
+### 4. 配置验证
+- AppID格式：以`wx`开头的18位字符串
+- AppSecret格式：32位字符串
+
+## ✅ 验证清单
+
+- [x] 修改SettingServiceImpl添加备用配置读取
+- [x] 添加getWeixinConfigFromWebsiteField方法
+- [x] 创建测试用例验证功能
+- [x] 提供SQL脚本检查和创建配置
+- [ ] 在cms_website_field表中创建AppID配置
+- [ ] 在cms_website_field表中创建AppSecret配置
+- [ ] 重启应用程序测试
+- [ ] 验证二维码生成功能正常
+
+## 🎉 总结
+
+通过修改`SettingServiceImpl`，现在系统支持从两个地方读取微信小程序配置：
+1. **主要来源**：`sys_setting`表（原有方式）
+2. **备用来源**：`cms_website_field`表（新增支持）
+
+当主要来源找不到配置时，系统会自动尝试从备用来源读取，这样就解决了你的配置问题，无需修改现有的`cms_website_field`表结构。
+
+只需要确保在`cms_website_field`表中有正确的`AppID`和`AppSecret`配置即可。