NextJS添加alternates至站点地图出现异常，求解决方法

问题原因 #

你的代码存在两个核心问题导致sitemap输出格式异常：

1. 主URL与alternates语言URL重复：主条目url为https://acme.com，同时在alternates.languages中又将es指向同一个URL，触发Next.js sitemap生成逻辑冲突，导致输出错误格式的内容。
2. 版本兼容性问题：MetadataRoute.Sitemap的alternates特性仅在Next.js 13.4.0及以上版本支持，若你的版本低于此标准，该字段不被识别，会导致生成失败。

解决方案 #

1. 修正alternates配置格式 #

确保每个语言版本对应独立的URL，且主条目的alternates中无需重复自身。同时，每个本地化页面都应在sitemap中单独注册并配置对应alternates：

import { MetadataRoute } from 'next'

export default function sitemap(): MetadataRoute.Sitemap {
  return [
    // 默认西班牙语站点（主站）
    {
      url: 'https://acme.com',
      lastModified: new Date(),
      alternates: {
        languages: {
          en: 'https://acme.com/en',
        },
      },
    },
    // 英语本地化站点
    {
      url: 'https://acme.com/en',
      lastModified: new Date(),
      alternates: {
        languages: {
          es: 'https://acme.com',
        },
      },
    },
  ]
}

2. 验证并升级Next.js版本 #

运行命令检查当前版本：

npm list next

若版本低于13.4.0，升级到最新稳定版：

npm install next@latest

3. 清除缓存并重启服务 #

修改配置后，清除Next.js缓存并重新启动开发服务器：

npx next clean
npm run dev

访问/sitemap.xml即可看到符合标准的XML格式站点地图，包含正确的语言alternates条目。

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