BeanPostProcessor的两个关键回调时机不可互换：postProcessBeforeInitialization在依赖注入前、初始化前执行，适合字段预填充和替换原始实例；postProcessAfterInitialization在初始化完成后执行，适合代理增强、AOP、校验最终状态。
BeanPostProcessor 的两个关键回调时机怎么选
Spring 容器在创建 Bean 实例后、初始化前会调用 postProcessBeforeInitialization，在初始化完成后（比如 @PostConstruct 执行完、afterPropertiesSet 调用完）调用 postProcessAfterInitialization。这两个时机不能互换：想改原始对象字段或替换代理前的实例，必须用前者；想包装成代理、加 AOP、校验最终状态，得用后者。
常见错误是把日志打印逻辑塞进 postProcessBeforeInitialization，结果发现 @Value 还没注入、@Autowired 字段仍是 null——因为此时依赖注入还没完成。
-
postProcessBeforeInitialization适合：字段预填充、早期校验、替换原始 bean 实例（返回新对象） -
postProcessAfterInitialization适合：代理增强、统计包装、权限检查、缓存装饰 - 两个方法都返回
Object，可返回原对象，也可返回新对象（容器后续只认你返回的那个）
如何安全地对特定类型 Bean 做处理而不影响全局
直接在 postProcessBeforeInitialization 里写 if (bean instanceof UserService) 看似简单，但容易漏掉子类、接口实现类，且硬编码类型耦合严重。更稳妥的方式是结合 bean.getClass().isAnnotationPresent(...) 或用 BeanFactory 查找匹配的 BeanDefinition 类型。
实际中推荐用 getBeanNamesForType 预扫描，或在处理器内部用 bean.getClass().getInterfaces() 判断是否实现某标记接口。避免用 instanceof 匹配具体实现类，尤其当项目用了 CGLIB 代理时，运行时类名可能是 UserService$$EnhancerBySpringCGLIB$$xxx。
- 用
bean.getClass().getDeclaredFields()获取字段时，记得设setAccessible(true)，否则私有字段读不到 - 若需修改 final 字段（如某些 SDK 内部常量），JDK 17+ 默认禁止反射修改，需启动参数加
--add-opens java.base/java.lang=ALL-UNNAMED - 不要在处理器里调用
applicationContext.getBean(...)，可能触发循环依赖或提前初始化未就绪的 Bean
为什么自定义 BeanPostProcessor 没生效？几个典型配置陷阱
最常见的失效原因是：类没被 Spring 扫描到，或者虽然注册了但优先级太低，被其他处理器覆盖了逻辑。Spring Boot 默认注册了多个 BeanPostProcessor（如 AutowiredAnnotationBeanPostProcessor、CommonAnnotationBeanPostProcessor），它们顺序靠前，你的逻辑如果依赖注解注入结果，就必须排在它们之后。
解决方式不是靠“最后注册”，而是显式实现 Ordered 接口或加 @Order 注解。数值越小优先级越高，Ordered.LOWEST_PRECEDENCE（值为 Integer.MAX_VALUE）表示最低优先级，适合做最终包装。
- 确保类上有
@Component或手动@Bean注册，纯普通类不会被识别 - 若使用
@Bean方式注册，方法返回类型必须是BeanPostProcessor，不能是子类名（否则 Spring 不识别其特殊语义） - 在测试环境（如
@SpringBootTest）中，若用new MyBPP()手动构造，它不会被容器管理，自然不生效
代理对象下 getBean() 返回值和原始类名不一致怎么办
当目标 Bean 被 @Transactional 或 @Cacheable 增强后，bean.getClass() 返回的是 CGLIB 生成的子类，而不是你写的原始类。这时候用 getClass().getName() 做类型判断会失败。正确做法是用 AopProxyUtils.ultimateTargetClass(bean) 获取最底层的目标类，或用 ClassUtils.getUserClass(bean)（Spring 自带工具）。
另一个坑是：在 postProcessAfterInitialization 中返回代理对象后，后续所有对该 Bean 的 getBean() 调用都会拿到代理，但如果你在处理器里又调用了 bean.toString() 或反射调用方法，而代理尚未完成初始化（比如事务拦截器还没设置好），可能抛出 IllegalStateException。
- 永远优先用
ClassUtils.getUserClass(bean)替代bean.getClass()做类型判断 - 若需在处理器中调用目标方法，先用
AopContext.currentProxy()（需开启expose-proxy=true）获取当前代理，再强制转型调用 - 不要在
postProcessAfterInitialization中递归调用beanFactory.getBean(...)，极易触发无限循环
复杂点往往不在逻辑本身，而在你处理的对象早已被其他处理器改造过——它可能不是你代码里写的那个类，甚至不是你预期的那个实例。动手前先确认 bean 是不是原始对象，再决定要不要 unwrap、要不要 defer、要不要绕开代理直接操作目标类。
