Spring Boot部署至AWS ECS Fargate运行时无法读取环境配置参数

核心问题是ECS任务定义中配置的环境变量名不符合操作系统环境变量的命名规范，无法被容器运行时正确注入到应用进程的上下文中。

• 包括AWS Fargate在内的所有容器运行时，底层依赖类Unix系统的环境变量机制，该机制对变量名有强制约束：仅允许使用大写英文字母、数字、下划线，禁止出现.（点号）、-（中划线）等特殊字符。你当前配置的PARAM.NAME、DB.USERNAME这类带点号的变量名，会被系统直接忽略，根本不会进入应用的环境变量列表。
• Spring Boot的环境变量自动映射基于宽松绑定规则实现，本身也不会识别带点号的环境变量名，自然无法完成配置映射。即便保留容器内原有的application.properties文件，只要文件内的配置项依赖这些不存在的环境变量做占位符替换，同样会出现读取不到配置值的问题。

不需要修改Spring Boot应用代码或原有application.properties内的配置项命名，仅需调整ECS任务定义中的环境变量命名即可：

1. 将所有environment和secrets配置段中的变量名做格式转换：把所有点号替换为下划线，统一使用全大写命名。Spring Boot的宽松绑定机制会自动将这类格式的环境变量映射到点分隔的配置项上，无需额外配置。
   修正后的配置段示例如下：

   "environment": [
     {
       "name": "PARAM_NAME",
       "value": "paramvalue"
     },
     {
       "name": "PARAM_NAME2",
       "value": "paramvalue2"
     }
   ],
   "secrets": [
     {
       "name": "DB_USERNAME",
       "valueFrom": "<db password in ssm>"
     }
   ]
   

2. 更新任务定义后重新部署服务即可正常读取配置。如果需要验证注入状态，可以临时在容器启动命令中添加env命令打印所有环境变量，或开启Spring Boot Actuator的/actuator/env端点查看已加载的配置项。

补充：如果有特殊场景必须使用带点的环境变量名（不推荐），可以在java启动命令中手动做参数映射，格式为java -jar app.jar --param.name=$PARAM_NAME，但这种方式会增加配置维护成本，优先选择标准命名方式。

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