本文档由 g2rain-model-nexus 的 docs/operations/troubleshooting.md 自动同步生成。

# 故障排查

现象	检查
/v1 返回失败	模型目录、协议客户端、供应商凭据、错误映射和请求模型名。
Embeddings 异常	模型类型、输入格式、维度参数和供应商能力。
启动失败	profile、Nacos、MySQL、Redis 与模型资料配置。
用量或数据异常	租户上下文、模型服务资料、版本/逻辑删除和审计记录。