AWS CodeBuild工作容器安装deb包报dpkg格式错误该如何解决？

该报错的核心原因是COPY到镜像内的deb包已损坏，并非合法的Debian安装包格式。本地运行正常、AWS环境异常的差异，基本是文件在代码传输、存储环节被篡改导致，可按以下步骤排查解决：

• 验证包完整性
  在现有RUN dpkg -i命令前插入校验逻辑，确认AWS构建环境中该文件的状态：

  COPY docker-assets/docker-ce_20.10.3_3-0_ubuntu-bionic_amd64.deb /home/folder/
  # 新增校验命令
  RUN ls -lh /home/folder/docker-ce_20.10.3_3-0_ubuntu-bionic_amd64.deb && file /home/folder/docker-ce_20.10.3_3-0_ubuntu-bionic_amd64.deb
  RUN dpkg -i docker-ce_20.10.3_3-0_ubuntu-bionic_amd64.deb
  

  正常deb包的file命令输出应为 Debian binary package (format 2.0)，如果输出为ASCII文本、未知数据等异常结果，即可确认包已损坏。
• 修复Git换行符转换问题（最高频触发原因）
  绝大多数此类场景是Git将deb二进制包识别为文本文件，自动做了CRLF/LF换行符转换导致文件损坏。你只需要在项目根目录的.gitattributes文件中添加规则，指定deb文件为二进制格式不做转换：

  *.deb binary
  

  配置完成后重新提交该deb包到代码仓库，再触发AWS构建即可。
• 清理构建缓存重试
  如果调整后仍报错，大概率是AWS构建服务缓存了之前包含损坏包的镜像层，你可以在构建时添加--no-cache参数禁用缓存，或者手动清理对应构建任务的缓存后重试。
• 可选优化方案
  你可以直接通过官方apt源安装指定版本的docker-ce，无需本地拷贝deb包，彻底规避本地文件损坏的风险。

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