Spring Boot应用中如何通过环境变量正确读取ASCII转义格式的配置属性值

这个问题我之前也碰到过，核心原因很简单：代码里的Unicode转义序列（比如\u00bf）是在编译阶段被JVM自动解析成对应字符的，但通过环境变量传入的转义字符串，Spring Boot默认只会把它当作普通的文本内容，不会去解析这些转义序列，所以才会出现你看到的差异。

下面给你几个可行的解决办法，按需选择：

方法一：自定义转换器解析Unicode转义 #

这是最灵活的方式，只针对特定的配置字段处理转义：

1. 首先引入Apache Commons Text依赖（它提供了现成的转义解析工具），如果用Maven的话，在pom.xml里加：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-text</artifactId>
    <version>1.10.0</version> <!-- 建议用最新稳定版 -->
</dependency>

2. 创建一个自定义的字符串转换器，用来解析Unicode转义：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import org.apache.commons.text.StringEscapeUtils;

@Component
public class UnicodeEscapeConverter implements Converter<String, String> {
    @Override
    public String convert(String source) {
        if (source == null) {
            return null;
        }
        // 解析Java风格的Unicode转义序列
        return StringEscapeUtils.unescapeJava(source);
    }
}

3. 在你的AppTemplateProps类的字段上标注使用这个转换器：

@Getter @Setter @Configuration @ConfigurationProperties("app.template")
public class AppTemplateProps {
    @Convert(converter = UnicodeEscapeConverter.class)
    String greeting = "\u00bfQu\u00e9 est\u00e1s haciendo %s?";
}

这样不管是从环境变量还是配置文件传入带Unicode转义的字符串，都会被自动解析成原生字符。

方法二：直接使用原生Unicode字符（最简单） #

如果你的运行环境支持输入原生的特殊字符，直接在环境变量里传入最终的字符串就行，不用写转义序列：
比如在Linux/bash中：

export app.template.greeting="¿Qué estás haciendo %s?"

注意要确保终端的编码是UTF-8，并且Spring Boot应用的运行环境编码也配置成UTF-8（通常默认就是，但可以通过-Dfile.encoding=UTF-8参数强制设置）。

方法三：全局配置解析（谨慎使用） #

如果你希望所有配置中的Unicode转义都被自动解析，可以实现EnvironmentPostProcessor来全局处理，但这种方式会影响所有配置项，需要确认不会带来其他问题：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.MutablePropertySources;
import org.springframework.core.env.PropertiesPropertySource;
import org.apache.commons.text.StringEscapeUtils;

import java.util.Properties;

public class UnicodeEscapeEnvironmentPostProcessor implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        MutablePropertySources propertySources = environment.getPropertySources();
        Properties processedProps = new Properties();
        
        // 遍历所有属性源，处理Unicode转义
        propertySources.forEach(source -> {
            if (source instanceof PropertiesPropertySource propsSource) {
                propsSource.getSource().forEach((key, value) -> {
                    if (value instanceof String strValue) {
                        processedProps.put(key, StringEscapeUtils.unescapeJava(strValue));
                    } else {
                        processedProps.put(key, value);
                    }
                });
            }
        });
        
        // 添加处理后的属性源到最前面，覆盖原有值
        propertySources.addFirst(new PropertiesPropertySource("processed-unicode-props", processedProps));
    }
}

然后在src/main/resources/META-INF/spring.factories里注册这个处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.yourpackage.UnicodeEscapeEnvironmentPostProcessor

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