Nuxt SSR部署Vercel后sitemap报Internal Server Error如何解决

问题描述 #

SSR模式下的Nuxt项目引入@nuxtjs/sitemap模块实现站点地图生成，配置完成后本地启动服务访问localhost:3000/sitemap.xml可正常展示内容，部署到Vercel平台后访问该路径始终返回Nuxt Internal Server Error，导致Google爬虫无法正常抓取站点内容。
现有Nuxt配置如下：

modules: [
    '@nuxtjs/pwa',
    '@nuxtjs/sentry',
    '@nuxtjs/sitemap',
    '@nuxtjs/robots'
  ],

  sitemap: {
    hostname: 'https://mysite.at',
    gzip: true,
    routes: [
      '/dynamic-page1',
      '/dynamic-page2'
    ],
    exclude: [
      '/admin/**',
      '/admin'
    ]
  },

已确认本地运行访问sitemap.xml无异常，仅Vercel部署环境触发报错。

可行修复方案 #

按以下优先级排查处理，绝大多数同类问题通过前两步即可解决：

• 关闭sitemap模块自带的gzip压缩
  Vercel边缘节点默认会对所有响应自动做gzip/brotli压缩，@nuxtjs/sitemap自带的gzip生成逻辑会在Vercel SSR运行时中因为响应头冲突、预压缩文件写入权限问题触发500错误。直接将sitemap配置中的gzip: true修改为gzip: false即可，压缩能力由Vercel平台自动接管，不会影响访问加载速度。
• 禁用模块本地文件缓存
  旧版本@nuxtjs/sitemap默认会在服务启动时将sitemap内容写入本地缓存文件，而Vercel Serverless函数运行时文件系统默认只读（仅/tmp目录有临时写入权限），缓存写入失败会直接抛错。如果关闭gzip后仍报错，先将@nuxtjs/sitemap升级到最新稳定版，或者在sitemap配置中添加cacheTime: 0，禁用本地文件缓存，改为请求时动态生成sitemap内容。
• 添加Vercel路由规则兜底
  在项目根目录新建或修改vercel.json文件，添加路由规则避免Vercel默认路由逻辑把sitemap.xml路径识别为静态资源拦截，导致请求没有走到Nuxt SSR服务：

  {
    "routes": [
      { "src": "/sitemap.xml", "dest": "/_nuxt/server-middleware" }
    ]
  }
  

• 校验构建与运行模式匹配
  如果部署时开启了静态生成（nuxt generate），需要确认构建阶段sitemap.xml是否成功生成到静态输出目录；纯SSR模式下建议将sitemap的生成时机配置为请求触发，不要在build构建钩子中提前生成文件，避免构建环境和线上运行时的目录结构差异导致文件找不到报错。

验证步骤：修改配置后重新触发Vercel部署，部署完成后直接访问/sitemap.xml路径，确认返回200状态码和正确的XML内容后，再到Google搜索控制台提交站点地图做可抓取性校验即可。

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