通过CodeDeploy同步CodeCommit至S3后HTML文件异常求助

1. 验证S3对象的实际元数据 #

直接查看推送后HTML文件的元数据，确认Content-Type和编码是否正确：

aws s3api head-object --bucket your-bucket-name --key path/to/your/file.html

• 确保Content-Type为text/html; charset=utf-8
• 检查是否存在错误的Content-Encoding（比如误设的gzip/deflate）
  如果元数据异常，在部署流程中添加元数据设置步骤：
  • 若使用CodeBuild，在buildspec.yml中执行aws s3 cp时附加--content-type text/html --content-encoding utf-8参数
  • 若使用CodeDeploy的S3部署配置，确保部署时保留原始文件元数据，或显式指定正确的Content-Type

2. 检查Git仓库的文件处理设置 #

Git的自动换行符转换可能导致文件内容混乱：

• 查看仓库的core.autocrlf配置：

git config --get core.autocrlf

如果值为true或input，建议针对静态文件仓库设置为false：

git config core.autocrlf false

重新提交并推送文件后，检查部署后的文件内容是否恢复正常。

3. 确认CodeBuild/部署流程的文件处理逻辑 #

如果用CodeBuild作为流水线构建阶段：

• 检查buildspec.yml中的打包或复制命令，确保以二进制模式传输文件。例如用aws s3 sync时，可通过--exclude "*" --include "*.html"批量设置Content-Type：

aws s3 sync ./ s3://your-bucket-name/ --exclude "*" --include "*.html" --content-type text/html

• 避免使用会修改文件内容的文本转换命令（如sed），除非有明确需求
• 若用zip打包部署包，使用zip -r命令，不要添加文本转换参数：

zip -r deploy.zip ./*

4. 检查CodeDeploy的部署配置 #

如果使用CodeDeploy的S3部署类型：

• 确认部署配置未开启文件压缩或转码选项
• 检查应用规范文件（appspec.yml）的复制规则，确保保留原始文件属性：

version: 0.0
os: linux
files:
  - source: /
    destination: s3://your-bucket-name/
    overwrite: true

5. 对比文件哈希值定位问题 #

对比本地文件、CodeCommit仓库文件、S3推送后文件的哈希值，确认文件损坏发生的阶段：

• 本地文件哈希：

sha256sum local-file.html

• CodeCommit中文件哈希：通过Git命令查看

git ls-files -s path/to/file.html

• S3中文件哈希：

aws s3api head-object --bucket your-bucket --key path/to/file.html | jq -r '.ETag'

（注意：未压缩的静态HTML文件，三者哈希应一致）

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