Strapi对接Netlify构建报错：构建Payload超出140kb限制如何解决

报错根因 #

你遇到的strapi error enqueueing build. build payload exceeded limit of 140 kb. please make sure environment variables and/or webhook body don't exceed this size.报错，本质是Strapi触发Netlify构建的webhook请求体大小超出了Netlify的140KB限制，绝大多数情况是你调整的落地页内容体量较大，Strapi默认把触发事件关联的全量内容数据都塞进了webhook请求体导致超限。

修复步骤 #

1. 精简Strapi webhook请求体 #

这是最常用的修复方案：

• 进入Strapi后台，依次打开「设置」-「Webhooks」，找到你配置的用来触发Netlify构建的webhook条目
• 找到Payload配置板块，关闭发送完整实体数据的开关，仅保留event、triggerAt这类必要的轻量字段即可
• 如果你是自定义开发的webhook触发逻辑，直接修改请求体为空白对象或者仅传几个标识字段即可，Netlify入站webhook不需要额外内容就能正常触发构建

2. 拆分webhook触发规则 #

如果精简请求体后仍然报错，排查触发规则配置：

• 如果你给这个构建webhook绑定了太多内容模型的增删改事件（比如同时绑定了落地页、文章、商品、全局配置等所有模型的变更事件），单次多实体同时变更也会撑大请求体
• 移除无关内容模型的触发绑定，仅保留需要触发全站构建的内容模型事件即可

3. 排查环境变量大小 #

报错提示同时包含环境变量超限的可能：

• 检查你在Strapi、Netlify后台配置的环境变量，是否存在大段文本、长拼接密钥这类过大的环境变量，Netlify单环境变量的大小限制同样为140KB左右，拆分过大的环境变量即可解决

4. 可选优化：改用增量构建触发 #

如果你的落地页经常做大范围内容调整，可以开启Gatsby增量构建能力，同时调整Strapi的触发逻辑，仅当对应落地页内容变更时才触发构建，进一步降低请求体大小。

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