GitLab Pages部署报artifacts for pages are too large错误咨询

报错信息：pages:deploy - artifacts for pages are too large

1. 确认全局配置是否生效 #

• 再次进入后台管理路径admin > settings > preferences > pages，确认Maximum size of pages archives (MB)字段确实已保存为2048，部分GitLab版本修改后必须点击页面底部的保存修改才会生效，临时修改未保存不会生效
• 若为多节点部署的GitLab实例，需确认配置已同步到所有应用节点，分布式部署场景下节点配置不同步会导致修改不生效

2. 检查项目/群组级独立限制 #

GitLab的项目、群组级Pages配置优先级高于全局配置，需要逐一排查：

• 进入对应部署项目的设置 > Pages页面，检查是否设置了单独的产物大小上限
• 若项目归属特定群组，进入对应群组的设置 > 通用 > Pages，确认群组级的Pages产物上限是否符合要求

3. 核实实际产物大小 #

很多场景下实际产物大小远大于预期值，建议做以下检查：

• 查看CI任务运行日志，搜索Uploading artifacts as "archive" to coordinator相关记录，确认实际上传的产物包大小
• 检查.gitlab-ci.yml中pages任务的artifacts.paths配置，确认仅包含需要部署的静态文件，避免误将构建缓存、依赖包等无关文件加入产物导致体积超标

4. 检查GitLab服务底层配置 #

自托管GitLab实例的gitlab.rb配置优先级高于后台页面配置，需做以下校验：

• 打开gitlab.rb配置文件，检查gitlab_pages['max_archive_size']参数，该参数单位为字节，2048MB对应值为2147483648，若参数值小于实际需要，修改为目标值
• 修改配置后执行gitlab-ctl reconfigure重载配置，再执行gitlab-ctl restart gitlab-pages重启Pages服务

所有配置调整完成后，手动触发一次CI流水线重新部署即可验证是否解决问题。

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