Next.js：如何避免public文件夹中XML文件被HTML包裹？

算力阿峰

2026-7-25

解决Next.js中sitemap.xml被HTML包裹的问题

基础排查步骤

确认sitemap.xml放在项目根目录的public文件夹下，无嵌套子目录，访问路径为你的域名/sitemap.xml
清除浏览器缓存，执行npm run build重新构建项目后重启服务，排除缓存干扰

Pages Router（pages目录）场景解决方案

检查pages目录下是否存在sitemap.xml.js/sitemap.xml.tsx这类路由文件，若有则删除或重命名，避免路由规则优先于静态文件
检查_document.js/_app.js，确保没有在全局逻辑中强制给所有响应包裹HTML结构，比如不要在getInitialProps中修改非HTML类型请求的响应

App Router（app目录）场景解决方案

如果存在app/[...not-found]/page.js这类兜底路由，可能会误拦截静态文件请求并返回HTML：

可以创建app/sitemap.xml/route.js文件，手动返回XML内容（替代静态文件），确保响应头正确：

import { NextResponse } from 'next/server';

export async function GET() {
  const sitemapContent = `<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <!-- 替换为你的站点地图内容 -->
  <url>
    <loc>https://你的域名/</loc>
    <lastmod>2024-05-20</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
</urlset>`;

  return new NextResponse(sitemapContent, {
    headers: {
      'Content-Type': 'application/xml',
    },
  });
}

配置文件检查

打开next.config.js，确保没有全局强制设置Content-Type为text/html的错误配置：

// 错误示例，需移除或修改
module.exports = {
  async headers() {
    return [
      {
        source: '/(.*)',
        headers: [{ key: 'Content-Type', value: 'text/html' }],
      },
    ];
  },
};

若有此类配置，调整为仅针对HTML页面生效，或直接删除该全局规则。