287 lines
7.1 KiB
Markdown
287 lines
7.1 KiB
Markdown
# 甘草 API "Array to string conversion" 错误修复总结
|
||
|
||
## 问题描述
|
||
在 Linux 服务器上调用甘草处方下单接口时，返回错误：
|
||
```json
|
||
{"code":2,"message":"Array to string conversion"}
|
||
```
|
||
|
||
## 已完成的修复
|
||
|
||
### 1. 代码层面修复
|
||
|
||
#### ✅ `GancaoScmRecipelService.php`
|
||
- 修复 `express_type` 字段：确保是字符串而不是数组
|
||
- 修复 `callback_url` 字段：确保是字符串而不是数组
|
||
- 修复患者年龄格式：从 `sprintf('%d.00', $ageInt)` 改为 `(string) $ageInt`
|
||
- 优化 `doct_advice` 字段处理：确保所有子字段都是字符串
|
||
- 添加调试日志：记录发送的完整负载
|
||
|
||
#### ✅ `PrescriptionOrderLogic.php`
|
||
- 修复 `$appNo` 变量引用问题
|
||
- 添加详细错误日志：记录失败时的完整请求和响应
|
||
- 添加 `use think\facade\Log;` 导入
|
||
|
||
#### ✅ `PrescriptionOrderController.php`
|
||
- 添加 try-catch 异常处理
|
||
- 添加返回值类型检查
|
||
- 添加详细日志记录
|
||
|
||
### 2. 诊断工具
|
||
|
||
创建了三个诊断脚本：
|
||
|
||
1. **`test_gancao_config.php`** - 配置检查脚本
|
||
- 检查所有配置项是否存在
|
||
- 检查配置值类型是否正确
|
||
- 检查是否有数组值被错误地用作字符串
|
||
- 测试 JSON 编码
|
||
|
||
2. **`diagnose_gancao_payload.php`** - 负载诊断脚本
|
||
- 测试 `buildPreviewPayload` 方法
|
||
- 测试 `buildSubmitPayload` 方法
|
||
- 检查每个字段的类型
|
||
- 测试 JSON 编码
|
||
- 保存负载到文件以便检查
|
||
|
||
3. **文档**：
|
||
- `GANCAO_API_FIX.md` - 初步修复说明
|
||
- `GANCAO_ARRAY_TO_STRING_FIX.md` - 完整解决方案
|
||
- `GANCAO_FIX_SUMMARY.md` - 本文档
|
||
|
||
## 下一步操作
|
||
|
||
### 步骤 1: 上传修复后的代码到服务器
|
||
|
||
```bash
|
||
# 上传修改的文件
|
||
scp server/app/common/service/gancao/GancaoScmRecipelService.php user@server:/path/to/server/app/common/service/gancao/
|
||
scp server/app/adminapi/logic/tcm/PrescriptionOrderLogic.php user@server:/path/to/server/app/adminapi/logic/tcm/
|
||
scp server/app/adminapi/controller/tcm/PrescriptionOrderController.php user@server:/path/to/server/app/adminapi/controller/tcm/
|
||
|
||
# 上传诊断脚本
|
||
scp test_gancao_config.php user@server:/path/to/
|
||
scp diagnose_gancao_payload.php user@server:/path/to/
|
||
```
|
||
|
||
### 步骤 2: 在服务器上运行配置检查
|
||
|
||
```bash
|
||
ssh user@server
|
||
cd /path/to/your/project
|
||
|
||
# 运行配置检查
|
||
php test_gancao_config.php
|
||
```
|
||
|
||
**期望输出**：
|
||
```
|
||
=== 甘草配置检查 ===
|
||
|
||
1. 检查配置是否存在:
|
||
✓ 配置已加载
|
||
|
||
2. 检查各项配置:
|
||
- enabled: ✓ boolean = true
|
||
- gateway_url: ✓ string = https://...
|
||
- gateway_ak: ✓ string = xxx
|
||
- gateway_sk: ✓ string = xxx
|
||
- biz_ak: ✓ string = xxx
|
||
- biz_sk: ✓ string = xxx
|
||
- callback_url: ✓ string = https://...
|
||
- express_type: ✓ string = sf
|
||
- cradle_store: ✓ string = xxx
|
||
- df_id: ✓ integer = 101
|
||
|
||
...
|
||
|
||
=== 检查结果: ✓ 配置正常 ===
|
||
```
|
||
|
||
**如果看到 ❌ 或 ⚠️**：
|
||
- 记录哪个字段有问题
|
||
- 检查 `.env` 文件中该字段的配置
|
||
- 修复后重新运行检查
|
||
|
||
### 步骤 3: 运行负载诊断
|
||
|
||
```bash
|
||
php diagnose_gancao_payload.php
|
||
```
|
||
|
||
这会：
|
||
- 测试负载构建过程
|
||
- 检查每个字段的类型
|
||
- 测试 JSON 编码
|
||
- 生成一个 JSON 文件（`gancao_payload_YYYYMMDDHHMMSS.json`）
|
||
|
||
检查生成的 JSON 文件，确保：
|
||
- 没有字段的值是 `"Array"`
|
||
- 所有字符串字段都是字符串
|
||
- 所有数组字段都是数组
|
||
|
||
### 步骤 4: 清除缓存
|
||
|
||
```bash
|
||
cd server
|
||
php think clear
|
||
|
||
# 或手动删除
|
||
rm -rf runtime/cache/*
|
||
rm -rf runtime/temp/*
|
||
```
|
||
|
||
### 步骤 5: 重启服务
|
||
|
||
```bash
|
||
# PHP-FPM
|
||
sudo systemctl restart php-fpm
|
||
|
||
# Nginx
|
||
sudo systemctl restart nginx
|
||
```
|
||
|
||
### 步骤 6: 测试接口
|
||
|
||
```bash
|
||
# 查看实时日志
|
||
tail -f server/runtime/log/$(date +%Y%m%d).log | grep -i gancao
|
||
```
|
||
|
||
在另一个终端调用接口：
|
||
```bash
|
||
curl -X POST https://your-domain.com/api/tcm.prescriptionOrder/submitGancaoRecipel \
|
||
-H "Content-Type: application/json" \
|
||
-H "token: your_token" \
|
||
-d '{"id": 订单ID}'
|
||
```
|
||
|
||
### 步骤 7: 检查日志
|
||
|
||
日志中应该看到：
|
||
|
||
**成功的情况**：
|
||
```
|
||
[info] Gancao CTM_SUBMIT_RECIPEL payload: {...}
|
||
[info] submitGancaoRecipel success: {...}
|
||
```
|
||
|
||
**失败的情况**：
|
||
```
|
||
[error] Gancao CTM_SUBMIT failed: {...}
|
||
[error] submitGancaoRecipel exception: {...}
|
||
```
|
||
|
||
## 常见问题排查
|
||
|
||
### 问题 1: 配置检查显示某个字段是数组
|
||
|
||
**解决方案**：
|
||
1. 编辑 `.env` 文件
|
||
2. 找到该字段的配置行
|
||
3. 移除 `[]` 和多余的引号
|
||
4. 示例：
|
||
```env
|
||
# 错误
|
||
GANCAO_SCM_EXPRESS_TYPE=["sf"]
|
||
|
||
# 正确
|
||
GANCAO_SCM_EXPRESS_TYPE=sf
|
||
```
|
||
5. 保存后清除缓存并重启服务
|
||
|
||
### 问题 2: JSON 中包含 "Array" 字符串
|
||
|
||
**解决方案**：
|
||
1. 运行 `diagnose_gancao_payload.php` 找出是哪个字段
|
||
2. 检查该字段在代码中的处理
|
||
3. 确保使用 `(string)` 强制转换
|
||
4. 检查配置文件中该字段的值
|
||
|
||
### 问题 3: 仍然报 "Array to string conversion"
|
||
|
||
**可能原因**：
|
||
1. 缓存未清除
|
||
2. 服务未重启
|
||
3. 上传的文件未生效
|
||
4. 配置文件有语法错误
|
||
|
||
**排查步骤**：
|
||
1. 确认文件已上传：`ls -la server/app/common/service/gancao/GancaoScmRecipelService.php`
|
||
2. 检查文件修改时间：`stat server/app/common/service/gancao/GancaoScmRecipelService.php`
|
||
3. 清除所有缓存：`rm -rf server/runtime/*`
|
||
4. 重启所有服务
|
||
5. 检查 PHP 错误日志：`tail -f /var/log/php-fpm/error.log`
|
||
|
||
### 问题 4: 配置检查通过但接口仍然失败
|
||
|
||
**排查步骤**：
|
||
1. 检查日志中的完整错误信息
|
||
2. 查看 `Gancao CTM_SUBMIT_RECIPEL payload` 日志，确认发送的数据
|
||
3. 检查甘草 API 返回的错误信息
|
||
4. 确认药材 ID 映射是否正确
|
||
5. 确认处方数据是否完整
|
||
|
||
## 验证修复成功
|
||
|
||
修复成功的标志：
|
||
|
||
1. ✅ `test_gancao_config.php` 全部通过
|
||
2. ✅ `diagnose_gancao_payload.php` 全部通过
|
||
3. ✅ 接口返回成功：
|
||
```json
|
||
{
|
||
"code": 1,
|
||
"msg": "甘草药方上传成功",
|
||
"data": {
|
||
"recipel_order_no": "GC...",
|
||
"app_order_no": "PO...",
|
||
"fee": {...}
|
||
}
|
||
}
|
||
```
|
||
4. ✅ 日志显示 `submitGancaoRecipel success`
|
||
5. ✅ 数据库 `prescription_order` 表中 `gancao_reciperl_order_no` 字段已更新
|
||
|
||
## 需要进一步帮助
|
||
|
||
如果以上步骤都无法解决问题，请提供：
|
||
|
||
1. **配置检查输出**：
|
||
```bash
|
||
php test_gancao_config.php > config_check.txt 2>&1
|
||
```
|
||
|
||
2. **负载诊断输出**：
|
||
```bash
|
||
php diagnose_gancao_payload.php > payload_check.txt 2>&1
|
||
```
|
||
|
||
3. **错误日志**：
|
||
```bash
|
||
tail -100 server/runtime/log/$(date +%Y%m%d).log > error.log
|
||
```
|
||
|
||
4. **接口响应**：
|
||
```bash
|
||
curl -X POST ... > response.json 2>&1
|
||
```
|
||
|
||
5. **`.env` 配置**（隐藏敏感信息）：
|
||
```bash
|
||
grep GANCAO_SCM .env > gancao_config.txt
|
||
```
|
||
|
||
将这些文件发送给技术支持进行分析。
|
||
|
||
## 总结
|
||
|
||
这次修复主要解决了配置值类型错误的问题。关键点：
|
||
|
||
1. **配置必须是正确的类型**：字符串字段不能是数组
|
||
2. **`.env` 格式很重要**：不要使用 JSON 语法或数组语法
|
||
3. **缓存必须清除**：修改配置后必须清除缓存
|
||
4. **日志很重要**：添加了详细日志帮助排查问题
|
||
|
||
希望这次修复能解决你的问题！
|