Spring属性键含下划线时，环境变量与属性映射的差异问题

这是Spring Boot宽松绑定机制下的预期行为，核心是环境变量与属性键的匹配规则细节，下面结合你的测试案例逐一说明：

核心匹配逻辑 #

Spring处理环境变量绑定的核心步骤是：将环境变量名转为小写，并用点（.）替换所有下划线（_），得到一个「标准形式」的属性键，再通过宽松匹配规则与配置中的属性键匹配——宽松匹配支持点（.）、连字符（-）、下划线（_）作为分隔符时互相等价，同时驼峰命名也能兼容这些分隔形式。

测试案例拆解 #

1. 案例1：属性键my.main_project vs 环境变量MY_MAINPROJECT
   环境变量转换后是my.mainproject，和原属性键的my.main_project（含下划线分隔）不匹配，所以未绑定成功。

2. 案例2：属性键my.main_project vs 环境变量MY_MAIN_PROJECT
   环境变量转换后是my.main.project，通过宽松匹配，点分隔等价于下划线分隔，因此能匹配my.main_project，绑定成功。

3. 案例3：属性键my.main.project vs 环境变量MY_MAIN_PROJECT
   转换后的环境变量与属性键完全一致，自然匹配成功。

4. 案例4：属性键my.main-project.person.first_name vs 环境变量MY_MAINPROJECT_PERSON_FIRSTNAME
   环境变量转换后是my.mainproject.person.firstname，原属性键的main-project对应宽松匹配的main.project或main_project，first_name对应first.name或first_name，和转换后的结果完全不匹配，因此未绑定。

5. 案例5：属性键my.main-project.person.first_name vs 环境变量MY_MAINPROJECT_PERSON_FIRST_NAME
   环境变量转换后是my.mainproject.person.first.name，其中mainproject无法匹配原属性键的main-project（连字符分隔的形式），因此整体不匹配。

正确的环境变量写法 #

对于属性键my.main-project.person.first_name，正确的环境变量应为MY_MAIN_PROJECT_PERSON_FIRST_NAME：

• main-project中的连字符需转为下划线，对应MAIN_PROJECT
• first_name中的下划线直接保留，对应FIRST_NAME
  这个环境变量转换后是my.main.project.person.first.name，通过宽松匹配会等价于my.main-project.person.first_name，就能成功绑定。

补充说明 #

官方文档未明确提及属性键含下划线的场景，是因为这属于宽松匹配的延伸逻辑：下划线既可以作为属性键的普通字符，也可以作为分隔符的等价形式，只要环境变量转换后的结果能通过宽松匹配覆盖目标属性键，就能绑定成功。

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