Next.js多域名Sitemap生成策略：整合静态与动态路由

// utils/i18n.ts (示例)
export const i18n = {
  locales: ["en", "cs", "de", "ua", "pl", "de-AT"],
  defaultLocale: "en",
};

// 定义语言到域名的映射
export const languageToDomains: Record<string, string> = {
  en: "www.example.com",
  cs: "www.example.cz",
  de: "www.example.de",
  ua: "www.example.ua",
  pl: "www.example.pl",
  "de-AT": "www.example.at", // 针对特定区域的域名
  // ... 其他语言和域名
};

// 假设 fetchAPI 是一个用于从CMS获取数据的函数
// 假设 PageEntity 是CMS页面数据的类型接口
// 假设 STRAPI_ENDPOINTS.PAGES 是CMS页面的API端点
import { ISitemapField } from "next-sitemap"; // next-sitemap 提供的类型

// ... 在 getServerSideProps 内部或辅助函数中
async function generateCmsSitemapFields(): Promise<ISitemapField[]> {
  const cmsFields: ISitemapField[] = [];

  for (const locale of i18n.locales) {
    // 从CMS获取指定语言的所有页面数据
    const urls = await fetchAPI<PageEntity[]>(`/${STRAPI_ENDPOINTS.PAGES}`, {
      params: { locale, populate: "localizations" },
    });

    urls?.forEach(
      ({ generatedUrl, updatedAt, localizations }) => {
        // 构建当前语言页面的 alternateRefs
        const alternateRefs = localizations?.map(
          ({ generatedUrl: altUrl, locale: altLocale }) => ({
            href: `https://${languageToDomains[altLocale]}${altUrl}`,
            hreflang: altLocale,
          })
        ) || [];

        // 添加当前语言页面的自身引用，确保完整性
        alternateRefs.push({
          href: `https://${languageToDomains[locale]}${generatedUrl}`,
          hreflang: locale,
        });

        cmsFields.push({
          loc: `https://${languageToDomains[locale]}${generatedUrl}`,
          lastmod: updatedAt,
          alternateRefs: alternateRefs,
        });
      }
    );
  }
  return cmsFields;
}

// ... 在 getServerSideProps 内部或辅助函数中
async function generateStaticSitemapFields(): Promise<ISitemapField[]> {
  const staticFields: ISitemapField[] = [];
  // 定义所有静态页面的基础路径，这些路径在所有语言版本中都存在
  const baseStaticPaths = ["/", "/about", "/contact", "/privacy-policy"]; // 示例路径

  for (const locale of i18n.locales) {
    for (const path of baseStaticPaths) {
      // 为当前路径和语言生成 alternateRefs
      const alternateRefs = i18n.locales.map((altLocale) => ({
        href: `https://${languageToDomains[altLocale]}${path}`,
        hreflang: altLocale,
      }));

      staticFields.push({
        loc: `https://${languageToDomains[locale]}${path}`,
        lastmod: new Date().toISOString(), // 静态页面的lastmod可以设置为部署时间或固定值
        alternateRefs: alternateRefs,
      });
    }
  }
  return staticFields;
}

import { GetServerSideProps } from "next";
import { getServerSideSitemap, ISitemapField } from "next-sitemap";
import { i18n, languageToDomains } from "../utils/i18n"; // 假设路径
import { fetchAPI, STRAPI_ENDPOINTS, PageEntity } from "../utils/api"; // 假设路径和类型

// 动态CMS页面Sitemap生成辅助函数
async function generateCmsSitemapFields(): Promise<ISitemapField[]> {
  const cmsFields: ISitemapField[] = [];

  for (const locale of i18n.locales) {
    const urls = await fetchAPI<PageEntity[]>(`/${STRAPI_ENDPOINTS.PAGES}`, {
      params: { locale, populate: "localizations" },
    });

    urls?.forEach(
      ({ generatedUrl, updatedAt, localizations }) => {
        const alternateRefs = localizations?.map(
          ({ generatedUrl: altUrl, locale: altLocale }) => ({
            href: `https://${languageToDomains[altLocale]}${altUrl}`,
            hreflang: altLocale,
          })
        ) || [];

        // 确保包含当前语言的自身引用
        alternateRefs.push({
          href: `https://${languageToDomains[locale]}${generatedUrl}`,
          hreflang: locale,
        });

        cmsFields.push({
          loc: `https://${languageToDomains[locale]}${generatedUrl}`,
          lastmod: updatedAt,
          alternateRefs: alternateRefs,
        });
      }
    );
  }
  return cmsFields;
}

// 静态页面Sitemap生成辅助函数
async function generateStaticSitemapFields(): Promise<ISitemapField[]> {
  const staticFields: ISitemapField[] = [];
  const baseStaticPaths = ["/", "/about", "/contact", "/privacy-policy"];

  for (const locale of i18n.locales) {
    for (const path of baseStaticPaths) {
      const alternateRefs = i18n.locales.map((altLocale) => ({
        href: `https://${languageToDomains[altLocale]}${path}`,
        hreflang: altLocale,
      }));

      staticFields.push({
        loc: `https://${languageToDomains[locale]}${path}`,
        lastmod: new Date().toISOString(),
        alternateRefs: alternateRefs,
      });
    }
  }
  return staticFields;
}

export const getServerSideProps: GetServerSideProps = async (ctx) => {
  const cmsFields = await generateCmsSitemapFields();
  const staticFields = await generateStaticSitemapFields();

  // 合并所有Sitemap字段
  const allFields = [...cmsFields, ...staticFields];

  return getServerSideSitemap(ctx, allFields);
};

// 默认导出以防止Next.js报错
export default () => {};

// next-sitemap.config.js
module.exports = {
  // siteUrl 仍然需要，但它不会用于生成Sitemap，而是用于 robots.txt 中的 Host 指令
  siteUrl: "https://www.example.com", // 您的主域名或默认域名
  // 排除 next-sitemap 尝试生成 sitemap.xml，因为我们已经通过 SSR 生成
  exclude: ["/server-sitemap.xml"],
  generateRobotsTxt: true, // 启用 robots.txt 生成
  robotsTxtOptions: {
    // 确保 robots.txt 引用我们通过 SSR 生成的 sitemap
    additionalSitemaps: [
      `https://www.example.com/server-sitemap.xml`, // 指向您的 SSR 生成的 Sitemap
      // 如果有其他 sitemap，例如针对特定域名或类型的，也可以在此处添加
      // `https://www.example.de/server-sitemap.xml`, // 针对其他域名的 sitemap
    ],
  },
  // transform 函数在此场景下不再需要用于 sitemap 转换，可以移除或保持默认
  // transform: async (_, path) => {
  //   return {
  //     loc: path,
  //     lastmod: new Date().toISOString(),
  //   }
  // }
};