4. 成功响应结构：成功刷新后返回的 access_token, refresh_token, expires_in, token_type 字段详解

当客户端使用有效的刷新令牌（Refresh Token）向令牌端点发起刷新请求时，授权服务器在验证通过后会返回一个标准的成功响应。该响应体通常采用 JSON 格式，包含四个核心字段：access_token、refresh_token、expires_in 和 token_type。理解每个字段的语义、约束和最佳实践，是正确实现刷新流程和进行故障定位的基础。

4.1 标准成功响应示例

以下是一个典型的成功刷新响应体（JSON 格式）：

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4..."
}

4.2 字段详解与约束

4.3 字段间的逻辑关系

四个字段并非孤立存在，它们共同构成了客户端后续行为的依据。以下关系图展示了字段之间的依赖与约束：

4.4 字段行为对比：轮换策略 vs 非轮换策略

刷新令牌的返回行为直接决定了客户端的安全模型。下表对比了两种常见策略下的字段差异：

4.5 字段解析与验证清单

在客户端实现中，建议对成功响应执行以下验证步骤：

1. 验证 JSON 结构完整性：确保响应体是合法 JSON，且包含 access_token、token_type、expires_in 三个必需字段。
2. 验证 token_type 值：严格检查是否为 Bearer（区分大小写）。
3. 验证 expires_in 合理性：检查值是否为正整数，且大于 0。建议设置最小阈值（如 60 秒），防止服务器返回异常短的有效期。
4. 处理 refresh_token：如果响应中包含此字段，立即替换本地存储的旧刷新令牌；如果不包含，保留现有刷新令牌。
5. 记录时间戳：记录收到响应时的本地时间戳，结合 expires_in 计算令牌的实际过期时间点，用于后续的预刷新调度。

// 客户端验证伪代码示例
function handleRefreshResponse(response) {
  if (!response.access_token || !response.token_type || !response.expires_in) {
    throw new Error('Invalid refresh response: missing required fields');
  }
  if (response.token_type !== 'Bearer') {
    throw new Error('Invalid token_type: expected Bearer');
  }
  if (response.expires_in <= 60) {
    console.warn('Warning: expires_in is too short:', response.expires_in);
  }
  // 更新存储
  storage.set('access_token', response.access_token);
  storage.set('expires_at', Date.now() + response.expires_in * 1000);
  if (response.refresh_token) {
    storage.set('refresh_token', response.refresh_token);
  }
}

4.6 常见响应异常与排查方向