排障
常见问题与快速修复
先执行基础诊断，再用问题矩阵定位最短修复路径。
基础诊断
mosaic --project-state status
mosaic --project-state health
mosaic --project-state doctor
mosaic --project-state logs --tail 80问题矩阵
| 现象 | 检查 | 常见修复 |
|---|---|---|
models list 返回 404 |
mosaic configure --show |
修正 base URL，避免 Azure 路径重复 /v1 |
command not found: mosaic |
which mosaic |
补齐 PATH 并重启终端 |
| 鉴权或网络错误 | mosaic health + 环境变量 |
检查 key 环境变量名称和值、endpoint 可达性 |
channels / gateway 检查
mosaic --project-state channels list
mosaic --project-state channels logs --channel all --tail 50
mosaic --project-state gateway probe