20、Spring陷阱：Feign AOP切面为何失效？配置优先级如何“劫持”你的设置？

Spring陷阱：Feign AOP切面为何失效？配置优先级如何"劫持"你的设置？

Spring框架凭借IoC和AOP大幅简化了Java开发，但其内部复杂度也常常让开发者踩坑。本文通过两个真实案例，深入剖析Feign AOP切面失效和Spring配置优先级问题，带你理解Spring背后的运行机制，避免类似问题。

案例一：Feign AOP切不到的诡异案例

现象

某项目使用Spring Cloud Feign进行服务调用，希望通过AOP统一记录Feign客户端调用日志。使用within(feign.Client+)切面切入所有feign.Client实现：

java 复制代码

@Aspect
@Slf4j
@Component
public class WrongAspect {
    @Before("within(feign.Client+)")
    public void before(JoinPoint pjp) {
        log.info("within(feign.Client+) pjp {}, args:{}", pjp, pjp.getArgs());
    }
}

测试两个Feign客户端：

Client：普通Feign客户端，无URL配置
ClientWithUrl：指定了URL属性的Feign客户端

java 复制代码

@FeignClient(name = "client")
public interface Client {
    @GetMapping("/feignaop/server")
    String api();
}

@FeignClient(name = "anotherClient", url = "http://localhost:45678")
public interface ClientWithUrl {
    @GetMapping("/feignaop/server")
    String api();
}

调用后发现：Client的请求有AOP日志输出，而ClientWithUrl的请求没有。

问题分析

Feign客户端实际是通过FeignClientFactoryBean创建的。查看其getTarget方法源码：

java 复制代码

<T> T getTarget() {
    FeignContext context = this.applicationContext.getBean(FeignContext.class);
    Feign.Builder builder = feign(context);
    if (!StringUtils.hasText(this.url)) {
        // 无URL：走负载均衡，返回LoadBalancerFeignClient（Bean）
        return (T) loadBalance(builder, context, new HardCodedTarget<>(this.type, this.name, this.url));
    }
    // 有URL：从LoadBalancerFeignClient中获取delegate
    String url = this.url + cleanPath();
    Client client = getOptional(context, Client.class);
    if (client != null) {
        if (client instanceof LoadBalancerFeignClient) {
            client = ((LoadBalancerFeignClient) client).getDelegate(); // 取出delegate
        }
        builder.client(client);
    }
    // ...
}

关键点：

无URL时，loadBalance方法返回的是LoadBalancerFeignClient（它是Spring容器中的Bean）。
有URL时，client被设置为LoadBalancerFeignClient的delegate，而这个delegate（如ApacheHttpClient）是直接new出来的，不是Bean。

java 复制代码

@Bean
@ConditionalOnMissingBean(Client.class)
public Client feignClient(CachingSpringLoadBalancerFactory cachingFactory,
                          SpringClientFactory clientFactory, HttpClient httpClient) {
    ApacheHttpClient delegate = new ApacheHttpClient(httpClient); // 非Bean
    return new LoadBalancerFeignClient(delegate, cachingFactory, clientFactory);
}

Spring AOP只能作用于由Spring容器管理的Bean 。因此，within(feign.Client+)无法切入非Bean的ApacheHttpClient。
是
否
是
FeignClientFactoryBean
url是否为空?
loadBalance方法
LoadBalancerFeignClient Bean
可被AOP切入
getOptional获取Client
client是LoadBalancerFeignClient?
取出delegate ApacheHttpClient
ApacheHttpClient 非Bean
无法被AOP切入

解决方案

让ApacheHttpClient也成为Bean，并调整AOP代理方式以适应其final类特性。

移除Ribbon依赖 ：当classpath中没有ILoadBalancer时，Spring Cloud会自动将ApacheHttpClient配置为Bean。

xml 复制代码

<!-- 注释掉ribbon依赖 -->
<!-- <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
</dependency> -->

切换AOP代理方式 ：ApacheHttpClient是final类，CGLIB无法继承，需改用JDK动态代理。

properties 复制代码

spring.aop.proxy-target-class=false

修改后，ClientWithUrl的请求也能被within(feign.Client+)切面捕获。

案例二：Spring程序配置的优先级问题

现象

某Spring Boot应用通过配置文件设置actuator管理端口：

properties 复制代码

management.server.port=45679

但发布后监控系统告警，发现管理端口变成了12345。原来运维在服务器上设置了环境变量：

bash 复制代码

export MANAGEMENT_SERVER_PORT=12345

环境变量覆盖了配置文件。类似地，开发者在配置文件中设置user.name=defaultadminname，但程序读取到的却是系统用户名（如zhuye）。这是Spring配置优先级导致的。

深入分析

Spring的Environment接口抽象了配置源（PropertySource）和剖面（Profile）。查询配置时，会按优先级遍历所有PropertySource，找到第一个匹配的值即返回。
渲染错误: Mermaid 渲染失败: Parse error on line 2: ...TD A[getProperty(key)] --> B[遍历Prope ----------------------^ Expecting 'SQE', 'DOUBLECIRCLEEND', 'PE', '-)', 'STADIUMEND', 'SUBROUTINEEND', 'PIPE', 'CYLINDEREND', 'DIAMOND_STOP', 'TAGEND', 'TRAPEND', 'INVTRAPEND', 'UNICODE_TEXT', 'TEXT', 'TAGSTART', got 'PS'

Spring Boot启动时，会将各种配置源按优先级排序。常见的PropertySource顺序（从高到低）：

ConfigurationPropertySourcesPropertySource（代理）
系统属性（systemProperties）
系统环境变量（systemEnvironment）
配置文件（applicationConfig）
...

我们编写代码列出所有PropertySource中user.name和management.server.port的值：

java 复制代码

@Autowired
private StandardEnvironment env;

@PostConstruct
public void init() {
    Arrays.asList("user.name", "management.server.port").forEach(key -> {
        env.getPropertySources().forEach(ps -> {
            if (ps.containsProperty(key)) {
                log.info("{} -> {} 实际取值：{}", 
                    ps, ps.getProperty(key), env.getProperty(key));
            }
        });
    });
}

输出节选：

复制代码

ConfigurationPropertySourcesPropertySource {name='configurationProperties'} -> zhuye 实际取值：zhuye
PropertiesPropertySource {name='systemProperties'} -> zhuye 实际取值：zhuye
OriginTrackedMapPropertySource {name='applicationConfig: [classpath:/application.properties]'} -> defaultadminname 实际取值：zhuye

可见user.name最终取值为zhuye（来自系统属性），而非配置文件的defaultadminname。

为什么ConfigurationPropertySourcesPropertySource排在最前？

Spring启动时，会调用ConfigurationPropertySources.attach(environment)，将ConfigurationPropertySourcesPropertySource添加到MutablePropertySources的第一个位置。它本身是一个代理，遍历时又会委托给底层的真实PropertySource，但会跳过自身和StubPropertySource。

java 复制代码

public static void attach(Environment environment) {
    MutablePropertySources sources = ((ConfigurableEnvironment) environment).getPropertySources();
    sources.addFirst(new ConfigurationPropertySourcesPropertySource(
        ATTACHED_PROPERTY_SOURCE_NAME,
        new SpringConfigurationPropertySources(sources))); // 代理
}

因此，虽然我们看到的第一个配置源是ConfigurationPropertySourcesPropertySource，但它实际查询时仍然会遍历所有底层源，但顺序已确定。

配置优先级总结

Spring Boot外部配置优先级（由高到低）：

命令行参数
来自java:comp/env的JNDI属性
Java系统属性（System.getProperties()）
操作系统环境变量
配置文件（application.properties / application.yml）
...（完整列表可参考官方文档）

注意：系统属性中的user.name是当前登录用户名，会覆盖配置文件中的同名属性，因此应避免使用user.name作为业务配置键。

总结与建议

AOP切面必须作用于Spring Bean ：在扩展Spring组件时，务必确认目标对象是否为容器管理的Bean。可以通过调试或applicationContext.getBeanNamesForType验证。
理解自动装配条件 ：Spring Cloud根据classpath中的依赖自动配置Bean，熟悉@Conditional系列注解有助于预判运行时Bean的存在。
配置命名避免冲突 ：不要使用user.name等系统属性键作为自定义配置，建议使用带业务前缀的键（如app.user.default-name）。
善用调试分析Spring内部流程：在关键构造方法设置断点，观察调用栈；或使用Arthas等工具动态追踪。

思考题

除了execution、within、@within、@annotation，Spring AOP还支持this、target、args、@target、@args指示器。你知道它们各自的作用吗？
能否利用配置优先级特性实现动态占位符替换？例如定义%%MYSQL.URL%%，根据应用名自动替换为真实数据库信息，从而避免明文密码出现在配置文件中？

欢迎在评论区分享你的见解和实践经验！