Troubleshooting

BYOE 故障排查手册

先定位,再修复,最后固化

高频故障速查表

端口占用

现象:byoe web 启动失败。

$ byoe web --port 8080

鉴权失败

现象:401/403。检查 API Key、base_url、模型名。

$ byoe models$ byoe doctor

调度不触发

检查 task 状态是否 active、heartbeat 是否开启、trigger 格式是否有效。

支持:interval:5m / once:2026-07-01T09:00:00 / */15 * * * *

重复失败

查看重试策略与审计日志,必要时设置 max_errors 截止无效重试。

GET /api/schedule/retryPOST /api/schedule/retryGET /api/schedule/audit?limit=100

四条命令快速定位环境问题

$ byoe --version$ byoe doctor$ byoe models$ byoe web --port 8080

排障后请沉淀为团队技能

把处理步骤写入 skills,避免同类问题重复出现。

回到快速上手