Docker Desktop启用WSL2后AWS CodeBuild本地构建无法加载AWS配置的问题

问题根因 #

WSL2模式下的Docker Desktop为Windows侧运行的容器服务，与WSL发行版的文件系统、路径解析逻辑存在天然隔离，而codebuild_build.sh原生路径检测逻辑仅适配Hyper-V后端的Docker规则，未兼容WSL2路径映射机制，直接触发两类异常：

• WSL Ubuntu发行版内执行命令时，脚本误判传入的.aws配置目录不存在，强制将AWS_CONFIGURATION环境变量置为NONE
• Git Bash环境下执行命令时，脚本生成的Windows风格路径未正确映射到容器挂载点，导致buildspec、源码文件读取失败

适配操作步骤 #

• 校验Docker Desktop的WSL集成配置
  • 打开Docker Desktop设置，进入Resources > WSL Integration配置页
  • 确认执行构建命令的Ubuntu发行版（20.04/18.04）已开启集成开关，同时勾选默认WSL发行版集成选项
  • 应用配置后，在WSL Ubuntu终端内执行docker run hello-world，确认Docker命令调用正常，避免误用Windows侧的独立Docker客户端
• 修正AWS配置目录的传入参数
  • 不要直接传入WSL原生文件系统下的~/.aws路径，先将.aws目录同步到Windows用户目录下（默认路径为C:/Users/你的用户名/.aws），规避WSL文件系统的跨容器访问权限问题
  • 执行脚本时，-c参数直接传入Windows格式的绝对路径：-c "C:/Users/你的用户名/.aws"
  • 若脚本依然自动将AWS_CONFIGURATION赋值为NONE，直接修改codebuild_build.sh的路径判断逻辑：定位到脚本中检测.aws目录是否存在的分支（if [ ! -d "$AWS_CONFIGURATION" ]），注释该校验逻辑，强制保留传入的配置路径值
• 统一所有本地路径的传入格式
  • 构建产物目录（-a）、源码目录（-s）、buildspec文件（-b）参数，全部替换为Windows格式绝对路径，不要使用WSL风格的/mnt/c/xxx格式，确保容器能正确挂载本地目录
  • 参考可直接运行的命令格式：

    ./codebuild_build.sh -i aws/codebuild/standard:5.0 -a "C:/code/your-project" -s "C:/code/your-project" -b "C:/code/your-project/buildspec.yml" -c "C:/Users/your-username/.aws"
    

• 凭证加载兜底方案
  若上述步骤完成后仍报MissingRegion类配置错误，可绕开脚本的目录读取逻辑，在执行构建命令前直接导出AWS环境变量：

  export AWS_ACCESS_KEY_ID=你的访问密钥
  export AWS_SECRET_ACCESS_KEY=你的私有密钥
  export AWS_DEFAULT_REGION=目标AWS区域
  

  环境变量会被CodeBuild容器自动继承，直接完成配置加载。

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