HaHafeng
dfc0fe0b9a
Summary: - Migrate PostgreSQL to pgvector/pgvector:pg15 Docker image - Successfully install and verify pgvector 0.8.1 extension - Create comprehensive Dify-to-pgvector migration plan - Update PKB module documentation with pgvector status - Update system documentation with pgvector integration Key changes: - docker-compose.yml: Switch to pgvector/pgvector:pg15 image - Add EkbDocument and EkbChunk data model design - Design R-C-R-G hybrid retrieval architecture - Add clinical data JSONB fields (pico, studyDesign, regimen, safety, criteria, endpoints) - Create detailed 10-day implementation roadmap Documentation updates: - PKB module status: pgvector RAG infrastructure ready - System status: pgvector 0.8.1 integrated - New: Dify replacement development plan (01-Dify替换为pgvector开发计划.md) - New: Enterprise medical knowledge base solution V2 Tested: PostgreSQL with pgvector verified, frontend and backend functionality confirmed
185 lines
3.9 KiB
Markdown
185 lines
3.9 KiB
Markdown
# 微信服务号配置错误修复（200002）
|
||
|
||
## ❌ 错误信息
|
||
```
|
||
检查消息推送配置失败: invalid args, 200002
|
||
```
|
||
|
||
## 🔍 问题原因
|
||
EncodingAESKey格式不符合微信服务号要求。
|
||
|
||
## ✅ 解决方案（2选1）
|
||
|
||
### 方案1：使用微信平台随机生成（推荐⭐）
|
||
|
||
**步骤：**
|
||
|
||
1. 在微信公众平台配置页面
|
||
2. **EncodingAESKey字段不要手动输入**
|
||
3. 点击右侧的 **"随机生成"** 按钮
|
||
4. 微信会自动生成43位密钥，例如：
|
||
```
|
||
abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG
|
||
```
|
||
5. **复制这个生成的密钥**
|
||
6. 填写完整配置：
|
||
```
|
||
URL: https://devlocal.xunzhengyixue.com/api/v1/iit/patient-wechat/callback
|
||
Token: IitPatientWechat2026JanToken
|
||
EncodingAESKey: [点击随机生成后复制的密钥]
|
||
消息加解密方式: 安全模式
|
||
```
|
||
7. 点击 **"提交"** 验证
|
||
8. **验证成功后**，复制微信生成的EncodingAESKey到 `.env` 文件：
|
||
```env
|
||
WECHAT_MP_ENCODING_AES_KEY=[微信生成的密钥]
|
||
```
|
||
9. **重启后端服务**（重要！）
|
||
|
||
---
|
||
|
||
### 方案2：使用OpenSSL生成（备选）
|
||
|
||
如果方案1不行，使用OpenSSL生成标准Base64密钥：
|
||
|
||
**Windows（PowerShell）：**
|
||
```powershell
|
||
# 生成Base64格式的43位密钥
|
||
$bytes = [System.Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
||
$base64 = [Convert]::ToBase64String($bytes)
|
||
$key = $base64.Substring(0, 43)
|
||
Write-Host "EncodingAESKey: $key"
|
||
```
|
||
|
||
**或者使用在线工具：**
|
||
1. 访问：https://www.base64encode.org/
|
||
2. 生成32字节随机数据
|
||
3. Base64编码
|
||
4. 截取前43位
|
||
|
||
---
|
||
|
||
## 📋 完整配置流程（推荐）
|
||
|
||
### Step 1: 使用微信平台生成密钥
|
||
|
||
1. 登录微信公众平台
|
||
2. 进入：设置与开发 → 基本配置 → 服务器配置
|
||
3. 点击"修改配置"
|
||
4. 填写以下信息：
|
||
|
||
| 字段 | 值 |
|
||
|-----|-----|
|
||
| URL | `https://devlocal.xunzhengyixue.com/api/v1/iit/patient-wechat/callback` |
|
||
| Token | `IitPatientWechat2026JanToken` |
|
||
| EncodingAESKey | **点击"随机生成"** 然后复制生成的密钥 |
|
||
| 消息加解密方式 | 安全模式（推荐） |
|
||
|
||
### Step 2: 提交验证
|
||
|
||
1. 点击"提交"
|
||
2. 微信会发送GET请求验证
|
||
3. 应该显示"配置成功"
|
||
|
||
### Step 3: 更新.env文件
|
||
|
||
编辑 `backend/.env`，替换EncodingAESKey：
|
||
|
||
```env
|
||
# 原来的（有问题）
|
||
# WECHAT_MP_ENCODING_AES_KEY=7yK9mN4pQ2wX5vL8hG3jR6tU1nB0cF9eM7aZ4xS2dY5
|
||
|
||
# 新的（从微信平台复制的）
|
||
WECHAT_MP_ENCODING_AES_KEY=微信生成的43位密钥
|
||
```
|
||
|
||
### Step 4: 重启后端服务
|
||
|
||
```bash
|
||
# 停止当前服务（Ctrl+C）
|
||
# 重新启动
|
||
cd D:\MyCursor\AIclinicalresearch\backend
|
||
npm run dev
|
||
```
|
||
|
||
### Step 5: 启用配置
|
||
|
||
返回微信公众平台，点击"启用"按钮
|
||
|
||
---
|
||
|
||
## 🧪 验证配置是否正确
|
||
|
||
### 方法1：查看后端日志
|
||
|
||
应该看到类似日志：
|
||
```
|
||
📥 收到微信服务号 URL 验证请求
|
||
✅ URL 验证成功，返回 echostr
|
||
```
|
||
|
||
### 方法2：测试关注事件
|
||
|
||
1. 微信扫码关注公众号
|
||
2. 查看后端日志是否有：
|
||
```
|
||
📥 收到微信服务号回调消息
|
||
🔐 检测到加密消息，开始解密...
|
||
✅ 消息解密成功
|
||
👤 用户关注公众号
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. ✅ **EncodingAESKey必须与微信平台配置完全一致**
|
||
2. ✅ **修改.env后必须重启服务**
|
||
3. ✅ **Token保持不变**：`IitPatientWechat2026JanToken`
|
||
4. ✅ **推荐使用微信平台的"随机生成"功能**
|
||
|
||
---
|
||
|
||
## 💡 为什么会出现这个错误？
|
||
|
||
微信服务号对EncodingAESKey的格式有严格要求：
|
||
- 必须是43位
|
||
- 必须符合Base64字符集（A-Z, a-z, 0-9, +, /）
|
||
- 我之前生成的密钥只包含字母和数字，缺少+和/，不符合标准
|
||
|
||
微信平台的"随机生成"功能会自动生成符合标准的密钥，所以推荐使用。
|
||
|
||
---
|
||
|
||
**立即行动：**
|
||
1. 进入微信公众平台配置页面
|
||
2. 点击"随机生成"EncodingAESKey
|
||
3. 提交配置
|
||
4. 复制密钥到.env
|
||
5. 重启服务
|
||
|
||
**预计用时：3分钟**
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|