在Next.js/Faust.js中用Yoast生成站点地图遇404问题排查

• 确认Next.js文件路由的正确性
  确保sitemap.xml.js文件确实放在项目根目录的/pages文件夹下，而非子目录。Next.js Pages Router完全基于文件路径生成路由，文件位置错误会直接导致404。此外，检查项目是否混用了App Router（/app目录），部分场景下Pages Router的文件会被忽略，但atlas-blueprint-portfolio默认使用Pages Router。

• 校验FaustJS版本与API兼容性
  确认@faustwp/core版本与官方文档匹配。较新版本的getSitemapProps需要传入source参数（即Faust的wpSource实例），否则无法正确拉取WordPress内容：

  import { getSitemapProps, wpSource } from '@faustwp/core';
  
  export default function Sitemap() {}
  
  export function getServerSideProps(ctx) {
    return getSitemapProps(ctx, {
      frontendUrl: process.env.FRONTEND_URL,
      source: wpSource,
    });
  }
  

• 检查WordPress端配置

  1. 确保WordPress已激活FaustWP插件，且REST API可正常访问（访问WP域名下的/wp-json，确认返回合法JSON数据）。FaustJS的sitemap依赖WP REST API拉取内容，API不可用会导致生成失败。
  2. 关于Yoast的sitemap_index.xml：该文件是WordPress端生成的，前端Next.js默认不会映射此路径。若需要在前端访问，需在next.config.js中添加重写规则，将请求代理到WP端：

     module.exports = {
       async rewrites() {
         return [
           {
             source: '/sitemap_index.xml',
             destination: `${process.env.WORDPRESS_URL}/sitemap_index.xml`,
           },
         ];
       },
     };
     

     注意替换process.env.WORDPRESS_URL为你的WP站点地址，并确保该环境变量已正确配置。

• 验证环境变量与逻辑正确性

  1. 确认FRONTEND_URL格式正确：必须包含完整协议（http/https），且末尾无斜杠，例如https://your-frontend-domain.com，格式错误会导致sitemap生成失败。
  2. 添加日志调试getServerSideProps的执行情况，检查参数与返回值：

     export function getServerSideProps(ctx) {
       console.log('FRONTEND_URL:', process.env.FRONTEND_URL);
       const props = getSitemapProps(ctx, {
         frontendUrl: process.env.FRONTEND_URL,
         source: wpSource,
       });
       console.log('Sitemap 返回数据:', props);
       return props;
     }
     

     启动项目后查看终端日志，确认参数和返回值符合预期。

• 排查Starter项目的自定义路由规则
  检查next.config.js中的rewrites、redirects或headers配置，这些规则可能拦截sitemap.xml请求导致404。同时查看是否存在路由中间件（/pages/_middleware.js），若中间件有请求过滤逻辑，需确保允许sitemap.xml路径通过。

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