# 故障排除

## 常见问题

### BCB 连接失败

**症状**: 无法连接到 STA WebService

**解决方案**:
1. 检查网络连接和防火墙规则
2. 验证 STA 环境配置（homologation/production）
3. 确认超时设置足够（默认 30 秒）

### 文件处理失败

**症状**: 文件状态显示 `failed`

**解决方案**:
1. 检查文件格式是否正确
2. 查看错误信息了解具体原因
3. 验证路由配置是否正确
4. 检查目标系统是否可用

### WebSocket 断开

**症状**: 实时更新停止

**解决方案**:
1. 检查 Phoenix 端点配置
2. 验证 CORS 设置
3. 查看浏览器控制台错误
4. 前端会自动重连（指数退避）

### 速率限制

**症状**: 收到 429 Too Many Requests

**解决方案**:
1. 检查当前速率限制配置
2. 减少并发请求数
3. 增大轮询间隔
4. BCB 限制：每机构 10 个并发，每分钟 120 个查询

### Poller 不工作

**症状**: 没有新文件被处理

**解决方案**:
1. 确认 Poller 服务已启用
2. 检查轮询间隔设置
3. 验证 BCB 连接状态
4. 查看系统日志