Azure App Service自定义Kudu部署报错：权限拒绝

我之前在配置Kudu自定义部署脚本时也踩过类似的权限坑，结合Azure部署的运行机制，给你几个实用的排查和解决方向：

1. 先确认自定义脚本的基础配置合规 #

• 检查你的.deployment文件是否正确指向部署脚本，格式要像这样：

  [config]
  command = deploy.sh
  

• 如果用bash脚本，开头必须加上shebang声明，确保Kudu用正确的shell执行：

  #!/bin/bash
  

• 本地打包前给脚本加上可执行权限，避免Kudu无法运行它：

  chmod +x deploy.sh
  

2. 确保脚本正确切换到目标子目录 #

权限拒绝很多时候是路径错误导致的——脚本没成功切到子目录，npm就会在无权限的系统目录瞎操作。可以在脚本里加上错误判断：

# 切换到你的Node.js子目录（比如src），如果切换失败直接终止脚本
cd src || exit 1

# 执行npm install时绝对不要加-g参数（全局安装会用到系统目录，肯定权限不足）
npm install --production

3. 规避npm全局安装的权限问题 #

如果项目必须用到全局npm包，别直接用npm install -g，改成把全局包安装到本地目录：

# 设置npm全局包的本地存放路径
export NPM_CONFIG_PREFIX="./.npm-global"
# 把本地全局目录加入PATH，确保后续能调用到安装的包
export PATH="./.npm-global/bin:$PATH"

# 现在可以安全安装全局包到本地，不会触发权限问题
npm install -g your-required-package

4. 查看Kudu日志精准定位问题 #

去Azure门户的应用服务里，进入部署中心 > 日志，查看Kudu执行部署脚本的完整日志。日志会明确指出是哪个命令、哪个路径触发了权限拒绝，比如如果看到EACCES: permission denied, mkdir '/usr/local/lib/node_modules'，那就是全局安装导致的问题。

5. 验证部署包的结构正确性 #

确保你的zip包解压后结构是对的，比如：

your-deploy.zip
├── .deployment
├── deploy.sh
└── src/
    ├── package.json
    └── ...（你的应用代码文件）

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