Nuxt项目启动报错：Cannot read properties of undefined (reading 'sitemap')

问题原因 #

1. 你安装的@nuxtjs/sitemap@2.4.0是为Nuxt 2设计的版本，和当前使用的Nuxt 3（v3.3.3）完全不兼容，这是触发Cannot read properties of undefined (reading 'sitemap')报错的核心原因。
2. package.json中同时存在@nuxtjs/sitemap和nuxt-simple-sitemap两个功能重叠的站点地图插件，会引发依赖冲突。

解决方案 #

1. 卸载不兼容及冲突插件 #

执行以下命令清理冲突依赖：

npm uninstall @nuxtjs/sitemap nuxt-simple-sitemap sitemap

2. 安装适配Nuxt3的新版插件 #

安装支持Nuxt3的最新版@nuxtjs/sitemap：

npm install @nuxtjs/sitemap --save-dev

3. 更新nuxt.config.ts配置 #

确保配置文件中仅保留新版插件，并可添加基础配置（可选）：

// https://nuxt.com/docs/api/configuration/nuxt-config
export default defineNuxtConfig({
    modules: [
        '@nuxtjs/tailwindcss',
        '@nuxtjs/sitemap'
    ],
    // 可选配置：替换为你的实际域名
    sitemap: {
        hostname: 'https://your-website-domain.com'
    }
})

4. 清理缓存并重启项目 #

rm -rf node_modules package-lock.json
npm install
npm run dev

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