​
本地预览失败

先确认 Node.js 版本和依赖安装状态： 
node -v
npm install
npm run dev
如果 Mintlify 报配置错误，优先检查 docs.json 的导航路径是否与实际 .mdx 文件一致。

​
页面 404

  • 确认页面文件存在。
  • 确认页面已加入导航或通过链接引用。
  • 确认部署使用的是最新提交。
  • 检查重定向规则是否把路径导向旧地址。

​
部署失败

Cloudflare Pages 失败时，先查看部署日志中的构建命令和输出目录。若使用命令行部署，确认本机 Cloudflare 登录状态仍然有效。