Next.js动态sitemap本地正常 生产环境访问报500错误

本地运行正常、生产返回500属于典型的环境差异导致的运行时错误，路由结构pages/server-sitemap.xml/index.tsx本身符合Next.js Pages Router规则，无需调整，按以下优先级排查：

1. 接口请求无容错导致运行时抛错 #

现有代码没有任何异常捕获逻辑，生产环境只要出现以下任意一种情况，就会直接抛出未捕获异常返回500：

• 生产服务器到后端接口https://backendapi.example.com/blog-list/的网络不通，包括防火墙拦截、后端接口白名单未加生产服务出口IP、接口超时无响应
• 后端接口返回非200状态码（比如403鉴权失败、500服务错误），直接调用response.json()会触发解析错误
• 接口返回格式不符合预期（比如返回错误提示文本、空值而非数组），调用data.map会直接报类型错误
  修复代码如下，增加超时、状态校验、类型判断和异常兜底：

import { GetServerSideProps } from "next";
import { getServerSideSitemap, ISitemapField } from "next-sitemap";

export const getServerSideProps: GetServerSideProps = async (ctx) => {
  // 手动指定XML响应头，避免部分版本next-sitemap生产环境丢失头信息
  ctx.res.setHeader('Content-Type', 'application/xml');
  
  try {
    const response = await fetch("https://backendapi.example.com/blog-list/", {
      signal: AbortSignal.timeout(10000), // 10秒超时，避免接口挂死
    });

    if (!response.ok) {
      throw new Error(`接口响应异常，状态码：${response.status}`);
    }

    const data = await response.json();
    const fields: ISitemapField[] = Array.isArray(data) 
      ? data.map((blog) => ({
          loc: `https://www.example.com/blog/${blog.blog_slug}`,
          lastmod: new Date().toISOString(),
        }))
      : [];

    return getServerSideSitemap(ctx, fields);
  } catch (err) {
    // 生产环境可在此处接入日志服务打印错误，快速定位根因
    console.error("站点地图生成失败：", err);
    // 异常时返回空站点地图，避免直接返回500影响搜索引擎抓取
    return getServerSideSitemap(ctx, []);
  }
};

export default function Site() {}

2. 反向代理/CDN规则拦截 #

如果在生产服务器本地直接请求Next.js服务的监听端口（比如执行curl http://127.0.0.1:3000/server-sitemap.xml）能正常返回XML内容，说明问题出在服务外层的转发规则：

• Nginx、Apache等反向代理默认配置了.xml后缀走静态资源目录查找，找不到对应静态文件就直接返回500，不会把请求转发给Next.js运行时
• CDN、WAF的防爬虫规则可能拦截动态生成的sitemap请求，直接返回500
  修改对应转发规则，将/server-sitemap.xml路径强制代理到Next.js服务端口即可。

3. 版本兼容问题 #

确认next-sitemap和Next.js的版本对应关系：

• Next.js 12.x 适配 next-sitemap@3.x ~ 4.x 版本
• Next.js 13+ Pages Router 适配 next-sitemap@4.2.x 以上稳定版本
  过低版本的next-sitemap在生产构建时存在响应头丢失、返回格式异常的问题，升级到对应稳定版即可。

内容的提问来源于stack exchange，提问作者hawaj