Troubleshooting

故障排查

无法连接到中转服务

错误： SERVER_UNREACHABLE

解决：

1. 确认服务正在运行：ps aux | grep wx-newspic
2. 确认服务器地址正确：--server https://your-server.com
3. 确认 API Key 正确：--api-key "sk-xxx"
4. 确认服务器防火墙已开放端口

中转服务器地址未配置

错误： SERVER_URL_MISSING

解决：

1. 通过 --server 参数指定中转服务器地址
2. 或设置环境变量 WECHAT_SERVER_URL / WX_NEWSPIC_SERVER
3. 或运行 wx-newspic credential set --server <url> 持久化配置

创建草稿失败

错误： DRAFT_FAILED

解决：

1. 检查中转服务器日志，查看微信 API 返回的详细错误
2. 确认 access_token 有效（运行 wx-newspic credential check）
3. 检查文章内容是否触发微信内容安全审核
4. 确认文章标题不超过 32 字、作者不超过 16 字、摘要不超过 128 字

微信凭证未找到

错误： CREDENTIAL_NOT_FOUND

解决：

1. 运行 wx-newspic credential show 查看当前状态
2. 使用 wx-newspic credential set 配置凭证
3. 或通过 --app-id / --app-secret 参数临时指定

图片上传失败

错误： UPLOAD_FAILED

解决：

1. 确认图片格式为 PNG/JPEG/JPG/GIF
2. 确认单张图片 ≤ 10MB
3. 确认图片路径正确、文件可读

IP 白名单问题

解决：

1. 获取服务器出口 IP：curl ifconfig.me
2. 登录微信公众号后台 → 开发 → 基本配置 → IP 白名单
3. 添加服务器 IP 到白名单