Nuxt 3集成Decap CMS部署Netlify后内容不显示求助

排查&修复步骤 #

1. 清理重复的Nuxt Content模块配置 #

你的nuxt.config.ts里同时在buildModules和modules中添加了@nuxt/content，Nuxt 3已废弃buildModules字段，统一使用modules，重复加载可能引发模块冲突，修改配置如下：

export default defineNuxtConfig({
  target: "static",
  devtools: { enabled: true },
  modules: ["@vueuse/nuxt", "@nuxt/ui", "@nuxt/content"],
  colorMode: {
    preference: "light",
  },
});

2. 确认Netlify构建命令正确 #

因为设置了target: "static"，必须使用静态生成命令而非服务端构建命令：

• 正确命令：npm run generate（对应nuxt generate，会生成完整静态站点到.output/public）
• 错误命令：npm run build（服务端渲染构建，静态部署场景下会导致内容无法正常读取）

在Netlify后台「Site settings → Build & deploy → Build command」中修改为npm run generate。

3. 确保Decap CMS内容已合并到主分支 #

你的Decap CMS配置了publish_mode: editorial_workflow，内容提交后会生成GitHub Pull Request，必须将PR合并到master分支，Netlify才会触发重新构建并部署最新内容，未合并PR时网站会保持旧状态或无内容。

4. 检查content目录是否被Git忽略 #

确认项目根目录的.gitignore文件未排除content目录，否则GitHub仓库不会包含内容文件，Netlify构建时无法读取内容。若.gitignore中有content/这类规则，直接删除即可。

5. 修正Decap CMS资源路径配置 #

当前public_folder配置指向本地目录，不符合网站访问路径规则，建议修改为：

backend:
  name: github
  repo: wen00033/nuxt-app
  branch: master
  base_url: https://selling-site.netlify.app

publish_mode: editorial_workflow
media_folder: content/img
public_folder: /img
site_url: https://selling-site.netlify.app

public_folder: /img表示上传的图片可通过网站根路径下的/img直接访问，同时确保content/img目录存在且已被Git追踪。

6. 通过Netlify构建日志定位问题 #

在Netlify后台「Deploys」页面打开最近的构建记录，查看完整日志，搜索nuxt-content相关报错，比如内容文件读取失败、路径解析错误、模块加载异常等，日志信息可直接定位问题根源。

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