Azure Linux WebApp部署Nuxt项目后出现“Nuxt not found”错误及根域名无法绑定Blob Storage的问题排查

结合你的场景和提供的package.json脚本，我整理了几个最可能的原因及对应的解决思路：

可能原因1：Nuxt 被误放在 devDependencies 中 #

很多开发者会习惯把Nuxt放在devDependencies里，但nuxt start是生产环境的运行命令，需要Nuxt包存在于生产依赖中。如果你的package.json里Nuxt归属devDependencies，当Azure WebApp以生产环境安装依赖时（比如执行npm ci --only=production或yarn install --production），Nuxt会被跳过安装，直接导致运行时找不到包。

解决办法：

• 修改package.json，将nuxt从devDependencies移到dependencies节点下
• 重新触发构建和发布流水线

可能原因2：部署时缺失Nuxt运行必需文件 #

nuxt start属于服务端渲染启动模式，需要以下核心文件/文件夹才能正常运行，如果流水线部署时没包含这些内容就会报错：

• .nuxt：nuxt build生成的核心运行产物文件夹
• node_modules：所有生产依赖包
• nuxt.config.js：Nuxt项目的配置文件
• package.json：项目依赖和脚本配置文件

解决办法：

• 检查你的流水线构建/发布步骤，确保上述文件都被完整上传到Azure WebApp
• 注意：dist文件夹是nuxt generate生成的静态产物，仅适合纯静态部署场景，不能替代.nuxt等文件用于nuxt start模式

可能原因3：Azure WebApp 启动命令配置不匹配 #

Azure Linux WebApp默认会尝试执行npm start，但如果你的项目用yarn管理依赖，或者需要自定义启动逻辑，就可能出现命令执行失败的情况。

解决办法：

1. 登录Azure门户，进入你的WebApp资源页
2. 转到配置 > 常规设置
3. 在启动命令中填写匹配的命令：
   • 用npm的话填：npm run start
   • 用yarn的话填：yarn start
4. 保存配置后重启WebApp

这个问题本质是DNS协议的硬性限制：

• 根域名（也叫顶点域名/apex domain）不允许配置CNAME记录，因为CNAME会强制覆盖该域名的所有DNS记录（包括NS、MX等），但根域名必须保留NS记录来指定DNS服务器，两者存在冲突。
• Azure Blob Storage的自定义域名绑定仅支持CNAME记录，因此无法直接将根域名绑定到Blob Storage。

解决办法：
你可以借助Azure的其他服务间接实现根域名访问：

• Azure Front Door：创建Front Door实例，将根域名通过A/AAAA记录绑定到Front Door的自定义域名，再将Front Door的后端指向你的Blob Storage静态网站。Front Door不仅支持根域名绑定，还能提供CDN加速、WAF防护等高级功能。
• Azure Traffic Manager：创建Traffic Manager配置文件，将根域名通过A记录绑定到Traffic Manager端点，再让Traffic Manager指向Blob Storage的静态网站地址。不过Traffic Manager仅负责流量路由，没有CDN加速能力。

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