Skip to content

alibaba/arthas / skills/spring-context

arthas-springcontext-issues-resolve

Verified

排查 Spring ApplicationContext / Bean / 配置注入等问题

FileKindSize
SKILL.mdskill md5.1 KB
---
name: arthas-springcontext-issues-resolve
description: 排查 Spring ApplicationContext / Bean / 配置注入等问题
---

# Spring Context / Bean 排查指南

原则:
- **先只读查询**(contains/beanNames/type/environment),避免直接 `getBean()` 触发 Bean 初始化产生副作用。
- **严格限量**:`vmtool -l` 控制实例数量;避免无条件输出完整 `getBeanDefinitionNames()`。


## 1) 获取并挑选正确的 ApplicationContext

优先尝试获取常见的 Spring Boot Context(通常是 `AbstractApplicationContext` 子类):

```bash
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`):

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

获取“来源”

```bash
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 ,可以尝试

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

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

假设你要查的 beanName 为 `fooService`:

```bash
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 时:

```bash
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`):

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

若返回多个候选(`NoUniqueBeanDefinitionException` 常见根因),只看候选名称即可:

```bash
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`)。

```bash
vmtool --action getInstances --className org.springframework.context.support.AbstractApplicationContext -l 1 --express '#ctx=instances[0], #bf=#ctx.getBeanFactory(), #bd=#bf.getBeanDefinition("fooService")'
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall