Spring Cloud Config Server自定义TextEncryptor端点正常，但配置源读取时无法解密问题

我之前也碰到过一模一样的问题——自定义加密器在/encrypt/decrypt端点工作正常，但配置文件里的{cipher}前缀属性就是不会被解密。核心原因通常是自定义的TextEncryptorLocator没有被Spring Cloud Config的配置解析逻辑优先选中，系统还是在用默认的加密器处理配置源。

下面给你几个排查和解决的关键点：

1. 确保自定义TextEncryptorLocator被标记为@Primary #

Spring Cloud Config默认会自己创建一个TextEncryptorLocator的实现，如果你的自定义Bean没有设置优先级，系统可能会选择默认的那个。所以一定要给你的Locator Bean加上@Primary注解，确保它被优先注入：

@Configuration
public class CustomEncryptionConfig {

    @Bean
    public TextEncryptor customTextEncryptor() {
        // 这里返回你的自定义加密器实现
        return new TextEncryptor() {
            @Override
            public String encrypt(String text) {
                // 你的加密逻辑
            }

            @Override
            public String decrypt(String encryptedText) {
                // 你的解密逻辑
            }
        };
    }

    @Bean
    @Primary // 关键：标记为优先Bean
    public TextEncryptorLocator customTextEncryptorLocator() {
        return key -> customTextEncryptor();
    }
}

2. 检查Config Server的配置是否开启了解密支持 #

确保你的Config Server配置文件（比如application.yml）里没有禁用解密功能：

spring:
  cloud:
    config:
      server:
        encrypt:
          enabled: true # 确保这个属性是true，默认也是true，但最好显式声明

3. 验证加密器的加载时机 #

有时候自定义加密器可能在配置源加载之后才初始化，导致解析配置时还没用到它。你可以通过在customTextEncryptor()方法里加日志，或者断点调试，确认它在Config Server启动时就已经被创建了。

4. 检查配置文件的格式和前缀 #

确保配置文件里的密文前缀是严格的{cipher}，没有多余的空格或者符号，比如：

org.prop={cipher}682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda

如果前缀写错了，Config Server会把它当成普通字符串处理，不会触发解密。另外，如果你用的是Git或者其他远程配置仓库，要确保最新的配置已经被Config Server拉取到，有时候可能缓存了旧的配置导致没生效。

按照上面的步骤调整后，应该就能让Config Server在加载配置源时使用你的自定义加密器解密了。我当时就是加了@Primary注解之后问题就解决了，你可以先试试这个关键点。

备注：内容来源于stack exchange，提问作者Hossein Boka