Docker部署的Asp.Net Core 5.0 API无法访问AWS Parameter Store如何解决？

结论 #

不需要在Docker容器内安装AWS CLI即可正常访问AWS Parameter Store，你的报错和缺少AWS CLI无关。

错误原因 #

你遇到的报错核心是AWS SDK缺少区域配置：

• 本地环境运行正常，是因为你的本地AWS配置（默认存放在~/.aws/config）中已经设置了默认的region参数
• 容器部署时，你仅传入了访问密钥、挂载了credentials文件，缺少AWS区域的配置，所以抛出No RegionEndpoint or ServiceURL configured异常

可行解决方案 #

方案1：启动容器时新增区域环境变量（无需修改代码） #

AWS .NET SDK默认会自动读取AWS_REGION环境变量作为默认区域，启动容器时新增该参数即可，示例命令：

docker run -d \
  -e AWS_ACCESS_KEY_ID=你的访问密钥ID \
  -e AWS_SECRET_ACCESS_KEY=你的秘密访问密钥 \
  -e AWS_REGION=你实际使用的AWS区域（例如us-east-1、cn-north-1） \
  你的镜像名称

方案2：挂载完整的AWS配置目录 #

除了credentials文件外，将本地的~/.aws/config文件也挂载到容器内对应用户的.aws目录下：

docker run -d \
  -v ~/.aws/credentials:/home/app/.aws/credentials:ro \
  -v ~/.aws/config:/home/app/.aws/config:ro \
  你的镜像名称

方案3：代码中显式指定区域 #

修改AddSystemsManager的配置，显式传入区域参数，避免依赖环境的默认配置：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            var envName = hostingContext.HostingEnvironment.EnvironmentName.ToString().ToLower();
            config.AddSystemsManager(options =>
            {
                options.Path = $"/{envName}";
                options.ReloadAfter = TimeSpan.FromMinutes(5);
                // 替换为你实际使用的AWS区域，也可以从配置文件/环境变量动态读取
                options.Region = Amazon.RegionEndpoint.CNNorth1;
            });
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

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