Spring Context / Bean 排查指南

原则：

• 先只读查询（contains/beanNames/type/environment），避免直接 getBean() 触发 Bean 初始化产生副作用。
• 严格限量：vmtool -l 控制实例数量；避免无条件输出完整 getBeanDefinitionNames()。

1) 获取并挑选正确的 ApplicationContext

优先尝试获取常见的 Spring Boot Context（通常是 AbstractApplicationContext 子类）：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 5

如果拿不到结果，可以尝试获取： org.springframework.context.ApplicationContext

如果获取到多个对象，可以从对象的 classloader 的 Class<?> name 来判断。

1. 应用的 ClassLoader 通常是包含 LaunchedURLClassLoader
2. 应用的 ClassLoader 绝不会是 com.taobao.pandora.service.loader.ModuleClassLoader

2) 获取配置项的值与来源

只看值（示例：server.port）：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].getEnvironment().getProperty("server.port")'

获取“来源”

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express '#env=instances[0].getEnvironment(), #ps=#env.getPropertySources().get("configurationProperties"), #ps.findConfigurationProperty("server.port")'

如果应用有集成 spring-boot-starter-actuator ，可以尝试

vmtool --action getInstances \
--className org.springframework.boot.actuate.env.EnvironmentEndpoint \
--express 'instances[0].environmentEntry("server.port")'

3) 按 Bean Name 验证是否存在（不触发初始化）

假设你要查的 beanName 为 fooService：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].containsBean("fooService")'
vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].containsLocalBean("fooService")'
vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].containsBeanDefinition("fooService")'
vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].getAliases("fooService")'

判读：

• containsBean=true 但 containsLocalBean=false：Bean 可能来自父 Context。
• containsBean=false 且你确定应该存在：优先检查是否选错 Context、@Profile/@Conditional、配置项/环境变量是否生效。

4) 在 Spring Context 里“搜” Bean（按关键词过滤，限制输出）

当你只有一个关键词（比如 order / datasource）而不知道精确 beanName 时：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express '#ctx=instances[0], #names=@java.util.Arrays@asList(#ctx.getBeanDefinitionNames()), #m=#names.{? #this.toLowerCase().contains("order")}, #m.subList(0, @java.lang.Math@min(#m.size(), 50))'

说明：

• 先用关键词把范围收敛，再最多输出 50 个候选；拿到候选 beanName 后回到第 3 步逐个验证。

5) 按类型查找 Bean（最适合定位“注入到了哪个实现”）

当你知道目标类型（接口/父类）全限定名时（示例：com.foo.OrderService）：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].getBeanNamesForType(@com.foo.OrderService@class)'

若返回多个候选（NoUniqueBeanDefinitionException 常见根因），只看候选名称即可：

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express 'instances[0].getBeansOfType(@com.foo.OrderService@class).keySet()'

提示：

• 若怀疑代理导致类型不匹配（JDK Proxy / CGLIB），应优先按接口类型查询，再决定是否需要获取实例进一步确认。
• 若 @com.foo.OrderService@class 报 ClassNotFound，通常是类加载器不对：先用 classloader（stats/instances/tree）找到应用的 classLoaderHash，再在 vmtool/ognl 上加 --classLoader <hash> 重新执行。也可以找到 classloader的 Class Name，再使用 --classLoaderClass 参数。

6) 查看 BeanDefinition（来源/工厂方法/作用域）

当你需要确认 Bean 是怎么注册进来的（@Bean 工厂方法？XML？自动扫描？）时，可尝试拿 BeanFactory 看 BeanDefinition（前提：Context 是 AbstractApplicationContext）。

vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express '#ctx=instances[0], #bf=#ctx.getBeanFactory(), #bd=#bf.getBeanDefinition("fooService")'