HTTP 200, nội dung Not Found

title: "HTTP 200, nội dung Not Found" subtitle: "Một triệu chứng, ba nguyên nhân" description: "Một case production debugging về GitHub token, Vercel deploy và raw.githubusercontent.com." dateCreated: "2026-07-26" dateUpdated: "2026-07-26"

kind: "article" topic: "debugging" category: "debug" experience: "detective" interactive: true difficulty: 3 estimatedMinutes: 12

status: "published" language: "vi"

tags:

• nextjs
• vercel
• github-api
• production-debugging
• mdx

Hệ thống cũ gọi API với header sau:

function githubHeaders(): HeadersInit {
  const headers = {
    Accept: "application/vnd.github+json",
    "X-GitHub-Api-Version": "2022-11-28",
  };

  if (process.env.GITHUB_API_TOKEN) {
    headers.Authorization = `Bearer ${process.env.GITHUB_API_TOKEN}`;
  }

  return headers;
}

Token hết hạn làm request bị từ chối. Logic khi đó coi việc fetch lỗi đồng nghĩa với việc bài viết không tồn tại.

Thế nhưng, sau khi xoá token ở local và thấy local chạy ổn, production vẫn tiếp tục hiện Not Found. Vì sao?

{
  "git": {
    "deploymentEnabled": false
  }
}

Deployment tự động từ Git của Vercel đã bị tắt. Pipeline chạy qua GitHub Actions và sự khác biệt giữa Node 18.20.2 và phiên bản Vercel CLI mới đã tạo ra "ảo giác" deploy thành công. Local đã xoá token, nhưng production thì vẫn còn giữ token hết hạn. Production không thiếu biến môi trường, production dư một biến đã hỏng.

Vấn đề gốc nằm ở chỗ hệ thống gọi hai endpoint khác nhau:

1. api.github.com/.../git/trees - trả về 401 khi token sai.
2. raw.githubusercontent.com - trả về 404 khi token sai.

if (
  (res.status === 401 || res.status === 403) &&
  process.env.GITHUB_API_TOKEN
) {
  return fetch(url, { headers: githubBaseHeaders() });
}

async function githubFetch(url: string): Promise<Response> {
  let res = await fetch(url, { headers: githubHeaders() });

  if (!res.ok && process.env.GITHUB_API_TOKEN) {
    console.warn(
      `[github-api] ${res.status} with token, retrying without auth`,
    );

    res = await fetch(url, {
      headers: githubBaseHeaders(),
    });
  }

  if (!res.ok && res.status !== 404) {
    throw new Error(
      `[github-api] Request failed ${res.status}: ${url}`,
    );
  }

  return res;
}