Next.js应用部署Azure遇BadRequest：函数内容过大的疑问

核心原因：混淆静态存储限制与API函数包限制 #

你遇到的104MB限制，并非Azure Static Web Apps的静态内容总存储配额，而是Serverless API函数包的单包大小限制——无论免费还是标准计划，这个限制都是100MB左右（对应报错里的104857600字节）。你在门户看到的250MB/500MB是静态内容的总存储上限，二者为独立配额。

本地.next文件夹27MB是静态内容大小，但部署时，Next.js的Server Components、API Routes或SSR相关代码会被打包为Azure Functions的函数包，这个包的体积超出100MB限制，才触发了报错。

可能的触发场景与解决办法 #

1. 函数包混入开发依赖 #

• 检查package.json，确认是否将仅用于开发的依赖（如eslint、prettier、next-dev相关工具）放在了dependencies中。这类依赖会被打包进函数包，导致体积膨胀。
• 解决：将开发依赖移至devDependencies，部署时Azure会自动忽略该目录下的包（需确保部署流程执行了npm ci --production或类似生产环境安装命令）。

2. 部署配置错误导致上传冗余文件 #

检查GitHub Actions配置文件（.github/workflows/azure-static-web-apps-xxx.yml）：

• 确认app_location指向项目根目录，output_location设置为.next（Next.js的构建输出目录）。
• 若项目没有独立的API文件夹（Next.js API Routes默认在pages/api或app/api下），不要额外指定api_location，避免误打包无关内容。
• 可添加skip_app_build: false确保仅上传构建后的产物，而非整个项目文件。

3. Server端代码体积过大 #

若你在Server Components或API Routes中使用了大量第三方库，这些库会被打包进函数包。可借助@next/bundle-analyzer分析Server端打包体积：

# 安装依赖
npm install @next/bundle-analyzer --save-dev

在next.config.js中添加配置：

const withBundleAnalyzer = require('@next/bundle-analyzer')({
  enabled: process.env.ANALYZE === 'true',
});

module.exports = withBundleAnalyzer({
  // 你的Next.js原有配置
});

执行ANALYZE=true npm run build查看Server端bundle的体积详情，针对性优化（如替换大体积库、动态导入非核心依赖）。

4. 部署缓存或冗余文件导致体积异常 #

GitHub Actions工作流可能缓存了旧的node_modules或构建产物，导致打包时混入冗余文件。可在工作流中添加清理步骤：

- name: Clean dependencies and build artifacts
  run: |
    rm -rf node_modules
    rm -rf .next

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