用途
这是一个面向 Spring 应用的排查指南，帮助你在不重启、不修改代码的前提下，用 Arthas 的 vmtool 查询运行中的 Spring ApplicationContext、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 来判断：应用的 ClassLoader 通常包含 LaunchedURLClassLoader；应用的 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")'
适用场景
- Bean 找不到或与预期不符，需要区分本地 Context 与父 Context。
- 配置项取值异常，需要确认值与来源。
- 按关键词或类型定位 Bean，排查注入到哪个实现。
- 怀疑 JDK Proxy / CGLIB 代理导致类型不匹配。
- 排查 NoUniqueBeanDefinitionException。
- 确认 Bean 的注册方式、工厂方法或作用域。
限制
- 部分操作（如查看 BeanDefinition）要求 Context 是 AbstractApplicationContext。
- 使用 --classLoader / --classLoaderClass 解决 ClassNotFound 的具体参数用法在资料中未完整给出。
- 具体安装方式与命令在资料中暂未提供。