Azure App Service部署Node.js项目提示磁盘空间不足如何解决

依赖优化 #

• 将构建、测试、lint 类的工具依赖全部迁移到 devDependencies，部署时只安装生产依赖，执行命令为 npm install --production。你可以在 Azure 部署配置中开启生产依赖安装选项，避免安装冗余的开发依赖，最多可以减少60%以上的 node_modules 体积。
• 替换大体积依赖：比如用 dayjs 替代 moment.js，按需引入 lodash 子模块而非全量引入，优先选择功能一致的轻量依赖包。
• 清理无效依赖：执行 npm prune 移除未声明的冗余依赖，也可以扫描项目中完全未被引用的依赖直接删除。

构建与仓库优化 #

• 开启生产构建的 tree shaking、代码压缩配置，删除未被调用的死代码，Vite、Webpack 等构建工具的生产模式默认已开启相关能力，确认你的构建命令使用的是生产模式而非开发模式。
• 压缩项目内的图片、音频等静态资源，非必要的大体积静态资源不要存入 Git 仓库，避免跟着部署包一起上传。
• 确认 .gitignore 中已配置 node_modules/ 忽略规则，不要将本地的 node_modules 提交到 Git 仓库，否则部署时会直接拉取这部分超大体积文件。

Azure 部署配置优化 #

• 调整部署流程，不要在 Azure 实例上执行依赖安装与构建，改为在本地或者流水线提前完成构建，仅将构建后的产物（通常是 dist 目录、package.json 等必要文件）部署到 App Service，彻底避免将构建过程的冗余文件传到服务端。
• 清理实例的已占用空间：进入 Azure 门户对应服务的 Kudu 高级工具，删除旧的部署历史缓存与 wwwroot 下的冗余文件，释放空间后再重新部署。

你遇到的磁盘不足报错确实大概率是 node_modules 总体积超过了你的 App Service 实例磁盘配额，按上述步骤优化后基本可以解决问题。

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