Netlify CLI部署Next.js应用遇异常，页面空白求解决方案

一、netlify deploy --build报path undefined错误 #

• 检查项目根目录的netlify.toml配置，确保正确指定构建输出目录：

  [build]
    command = "npm run build"
    publish = ".next"
  

  没有这个文件就新建一个，避免CLI自动识别路径出问题。
• 清除Netlify本地缓存后重试：
  执行netlify cache:clear，再重新运行netlify deploy --build，缓存异常可能导致路径识别失效。
• 更新Node.js和Netlify CLI版本：
  确保Node.js版本符合Next.js要求（推荐18.x及以上），同时把Netlify CLI更到最新：npm install -g netlify-cli，旧版本可能存在路径处理的bug。

二、分开执行netlify build和netlify deploy后站点空白 #

• 安装并配置Netlify Next.js插件：
  先执行npm install @netlify/plugin-nextjs --save-dev，然后在netlify.toml里添加插件配置：

  [[plugins]]
    package = "@netlify/plugin-nextjs"
  

  这个插件是Netlify适配Next.js SSR/SSG的核心，缺失会导致页面无法正常渲染。
• 确保用生产环境构建：
  Windows环境执行set NODE_ENV=production && netlify build，Mac/Linux执行export NODE_ENV=production && netlify build，开发模式构建的产物部署后会出现空白。
• 检查资源加载和路由：
  打开浏览器F12的Console和Network标签，看是否有404资源或路由错误。如果站点部署在子路径，需要在next.config.js里配置basePath：

  module.exports = {
    basePath: '/你的子路径'
  };
  

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