# 常见问题与解决方案

## 钱包相关

### Q: check-wallet 返回 code=200 但 message 为"已申请开通，等待授权"
**原因**：钱包已申请但尚未在支付宝内完成授权
**解决**：调用 alipay-authenticate-wallet 技能，引导用户扫码完成授权

### Q: check-wallet 返回 code=500
**原因**：钱包未开通
**解决**：调用 alipay-authenticate-wallet 技能执行 apply-wallet

### Q: bind-wallet 返回"买家和卖家不能相同"
**原因**：绑定的钱包账号与商品卖家是同一个支付宝账号
**解决**：使用另一个支付宝账号重新绑定

### Q: bind-wallet 返回"服务sellerId不匹配"
**原因**：绑定的钱包对应的卖家ID与Payment-Needed中的卖家ID不一致
**解决**：关闭当前钱包，用正确的卖家账号重新绑定

---

## 支付相关

### Q: 402-buyer-pay 返回"请求已过期"
**原因**：Payment-Needed 数据已超过 pay_before 时间
**解决**：重新从服务器获取新的 Payment-Needed 数据

### Q: 402-buyer-pay 返回"卖家签名校验失败"
**原因**：Payment-Needed 数据中的签名与当前卖家私钥不匹配
**解决**：重新从服务器获取 Payment-Needed 数据并重试（最多3次）

### Q: 支付二维码已过期
**原因**：用户长时间未扫码支付
**解决**：重新发起支付，获取新的二维码

### Q: 轮询超时（>3分钟无响应）
**可能原因**：
1. 用户尚未扫码支付
2. 支付宝网络延迟
3. 服务器未运行
**解决**：提示用户检查是否已完成扫码，或稍后重试

---

## 交付与获取相关

### Q: 支付成功但未获取到网盘链接
**原因**：订单可能异常或调用 `/verify` 接口失败
**解决**：检查 `Payment-Proof` 凭证是否构造正确并传入，或检查系统后端服务状态

### Q: 接口返回 402 而非网盘链接
**原因**：Payment-Proof 格式不正确或交易号不匹配
**解决**：使用正确的 trade_no 重新生成 Payment-Proof 并再次调用 `/verify` 接口

---

## 服务器相关

### Q: 无法连接到 STORE_BASE_URL (如 https://store.bushrose.cn)
**原因**：Flask 服务器未启动或域名解析问题
**解决**：
确认后台服务器已正确部署并运行，如需本地测试，可运行：
```bash
python app.py
```

### Q: 服务器返回 500 错误
**原因**：服务器代码异常
**解决**：管理员需查看终端日志或错误日志（如 `logs/error.log`），检查 `.env` 配置及代码是否正确

---

## 网络相关

### Q: alipay-bot 命令执行超时
**原因**：网络连接不稳定
**解决**：检查网络连接，可重试1次；连续失败提示用户检查网络

### Q: curl 命令返回 connection refused
**原因**：后台服务器未启动或端口被占用
**解决**：确认服务器已启动，检查对应端口是否被其他程序占用