---
title: "排障"
description: "认证、Pool 缺失、限额与证据的常见症状、原因与修法。"
---

> Documentation Index
> Fetch the complete documentation index at: https://help.airuntime.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 排障

先找症状，再看原因。下面每条都点出真正决定结果的那个对象，方便你直接去核对。

## Gateway 返回 `401`

**原因：** Key 缺失、格式不对、已吊销、签发给了另一个 Environment，或者属于另一个 Home Cloud。

**修法：** 用 `Authorization: Bearer <key>` 发送；确认这个 Key 仍出现在你调用的 Environment 的
**API keys** 里；确认 Workspace 的 Home Cloud 与 Key 一致。

## 我的 Pool 不在 `GET /v1/models` 里

**原因：** 这个接口只列 Key 真正能调用的东西。Key 没有被授权、Pool 已暂停、Agreement 不覆盖该能力、
provider 连接不可用，或 fallback 策略无法满足，都会让 Pool 消失。

**修法：** 先查 Pool 的状态与授权，再查 provider 连接，最后查该项能力的权益。

## `429 quota_runtime_rate_limit_exceeded`

**原因：** 触到了 Pool 的每分钟上限，或按 Key 的上限。

**修法：** 等窗口重置、有意地调高上限，或把流量拆到多个 Key 上。立刻重试只会更糟。

## `429 quota_hard_budget_exceeded`

**原因：** Pool 的剩余硬预算不足以覆盖这次请求。错误体里带着上限与剩余金额。

**修法：** 调高 Pool 预算、等下个周期，或把低优先级负载挪到另一个 Pool。Gateway 宁可拒绝请求，也不
赊账服务。

## 控制台显示 `Unavailable`

**原因：** 快照在这个区间、作用域或字段上还没有证据。

**修法：** 检查时间窗和当前选中的 Pool。AI Runtime 不会把从未观测过的时段写成零，也不会用单次观测
画曲线。

## 我需要那次失败请求的确切记录

用错误体里的 `requestId`，或响应头里的 `x-airuntime-request-id`，在控制台打开 **Requests**。
幂等重放保留第一次的 Request ID，所以重试不会盖掉原始那一次。

## Codex 里没有我要的模型

**原因：** Codex 发的是它目录里的模型名，而那个名字必须是这个 Key 能调用的 Pool slug。

**修法：** 把 `~/.codex/config.toml` 里的 `model` 和 Pool slug 对一遍，再确认 `GET /v1/models`
用同一个 Key 能返回它。[接入 Codex](/zh-hans/codex/integrate-with-codex/) 把整个文件讲了一遍。

## 还是卡住了？

用联系表单，或写 `support@gridheap.com`，附上 Workspace id、Pool slug、UTC 时间和 `requestId`。
不要发送 prompt、输出、凭据或客户数据。

Source: https://help.airuntime.dev/zh-hans/troubleshooting/index.mdx
