Arthas ognl 表达式从入门到实战：掌握在线调试最强的表达式引擎

大家好，我是程序员天天困。

Arthas 系列写到第七篇了，还剩最后一篇就完结。前六篇我们一块儿学了 watch、trace、vmtool、mc+retransform、profiler，上一篇刚聊完 classloader + sc 的类加载排查。今天这篇的主角是 Arthas ognl 表达式——在我看来，它才是整个 Arthas 命令集里灵活度最高的那个。

很多同学刚开始用 Arthas 的时候，觉得 ognl 好像没啥用——watch 和 trace 不就够了吗？但假设你遇到这样一个场景：线上某个接口返回的结果不对，你想看中间某一步计算出的变量值。加日志？要重新部署。用 watch？只能看到方法入参和返回值，中间步骤的数据一片黑。这时候 ognl 就是救星——一行表达式，直接从 JVM 里捞出那个中间变量。看完这篇你就明白，它很可能是 Arthas 里最被低估的命令。

今天这篇，我会从 OGNL 是什么讲到 Arthas 里怎么用，最后聊聊它和 vmtool 到底什么关系。看完你就理解为什么我把 ognl 放在倒数第二篇——它是 Arthas 灵活度的天花板。

一、OGNL 是个啥？从 MyBatis 动态 SQL 说起

先不急着打命令。你可能没用过 OGNL，但你大概率间接用过它。

写过 MyBatis 的同学对这玩意儿一定不陌生：

<select id="findByCondition" resultType="User">
  SELECT * FROM user WHERE 1=1
  <if test="name != null and name != ''">
    AND name = #{name}
  </if>
  <if test="age != null and age > 0">
    AND age = #{age}
  </if>
</select>

注意 <if test="..."> 里的表达式——name != null and name != ''，这个 test 里的内容，底层就是交给 OGNL 引擎去解析执行的。你天天写的动态 SQL 条件，其实都是 OGNL 表达式。

那 OGNL 到底是什么？

OGNL（Object-Graph Navigation Language，对象图导航语言）：一种表达式语言，用简洁的点号路径在 Java 对象图中定位字段、调用方法、操作集合。你可以把它理解为「对象世界里的 GPS 导航」——给它一个路径表达式，它就能在层层嵌套的对象里找到你要的东西。

二、表达式语言是一家：OGNL、SPEL，都姓 EL

OGNL 全称里有个关键词叫 Expression Language，翻译过来就是「表达式语言」。这个家族人不少，你可能天天都在用只是没意识到。

EL（Expression Language，表达式语言）：一种以字符串形式编写逻辑的脚本机制，运行时由引擎解析执行，操作对象的属性和方法。你给一段表达式文本，引擎帮你翻译成实际的 Java 调用。

Java 生态里常见的 EL 有这三种：

EL 类型	全称	常见场景	写法示例
OGNL	Object-Graph Navigation Language	MyBatis 动态 SQL、Arthas、Struts2	user.name、skills[0]
SPEL	Spring Expression Language	Spring @Value 注入、@Cacheable key	#{systemProperties['user.home']}
JSTL EL	JSP Standard Tag Library EL	JSP 页面 ${}	${user.name}、${fn:length(list)}

它们的本质是一样的：用一段字符串表达式替代冗长的 Java 调用代码，由引擎在运行时解析执行。区别只是语法糖不同、适用场景不同。

拿 SPEL 举一个最常见的例子——Spring 里注入系统属性：

@Component
public class AppProperties {
    @Value("#{systemProperties['java.version']}")
    private String javaVersion;
}

#{systemProperties['java.version']} 就是一段 SPEL 表达式，Spring 容器启动时帮你解析成 System.getProperty("java.version") 的实际调用。关于 SpEL 的更多实战用法，我之前写过一篇《如何优雅记录操作日志》，里面详细讲了 SpEL 在日志场景里的应用，感兴趣可以去看看。

OGNL 和 SPEL 的核心区别在于：SPEL 是 Spring 生态的亲儿子，深度集成在 IoC 容器里；OGNL 更独立、更通用，可以在任何 Java 程序里单独用，这也是 Arthas 选它做表达式引擎的原因——不挑框架，拿来就能用。

三、脱离 Arthas，OGNL 单独怎么用

在聊 Arthas 的 ognl 命令之前，我们先看一下 OGNL 作为独立库是怎么工作的。搞懂它的「裸用」方式，你在 Arthas 里写 ognl 表达式才能举一反三。

Maven 依赖：

<dependency>
    <groupId>ognl</groupId>
    <artifactId>ognl</artifactId>
    <version>3.3.4</version>
</dependency>

假设我们有两个类：一个微服务配置 AppConfig 和一个服务实例 MicroService：

@Getter
@Setter
public class AppConfig {
    private String env;
    private int maxConnections;
    private List<String> allowedOrigins;
    private Map<String, Object> extraParams;

    public AppConfig(String env, int maxConnections) {
        this.env = env;
        this.maxConnections = maxConnections;
        this.allowedOrigins = new ArrayList<>();
        this.extraParams = new HashMap<>();
    }
}

@Getter
@Setter
@AllArgsConstructor
public class MicroService {
    private String serviceName;
    private AppConfig config;
}

构造测试数据：

AppConfig config = new AppConfig("production", 100);
config.getAllowedOrigins().addAll(Arrays.asList("https://a.example.com", "https://b.example.com"));
config.getExtraParams().put("timeout", 5000);
config.getExtraParams().put("retryCount", 3);

MicroService service = new MicroService("order-service", config);

OgnlContext context = new OgnlContext(null, null, null);
context.setRoot(service);

现在我们用 OGNL 表达式来访问 service 对象里的各种数据。注意——同样的数据，你如果用 Java 写，得一串 getter 调用；用 OGNL，一行字符串就搞定：

// 1. 基本属性访问 —— 等效于 service.getConfig().getEnv()
String env = (String) Ognl.getValue("config.env", context, service);
System.out.println("环境: " + env);  // 输出: 环境: production

// 2. 访问 List 元素 —— 等效于 service.getConfig().getAllowedOrigins().get(0)
String firstOrigin = (String) Ognl.getValue("config.allowedOrigins[0]", context, service);
System.out.println("首个来源: " + firstOrigin);  // 输出: 首个来源: https://a.example.com

// 3. 访问 Map 值 —— 等效于 service.getConfig().getExtraParams().get("timeout")
Integer timeout = (Integer) Ognl.getValue("config.extraParams['timeout']", context, service);
System.out.println("超时时间: " + timeout);  // 输出: 超时时间: 5000

// 4. 链式方法调用 —— 在导航路径上直接调方法
String upperEnv = (String) Ognl.getValue("config.env.toUpperCase()", context, service);
System.out.println("大写环境: " + upperEnv);  // 输出: 大写环境: PRODUCTION

// 5. 设置属性值
Ognl.setValue("config.maxConnections", context, service, 200);
System.out.println("新连接数: " + service.getConfig().getMaxConnections());  // 输出: 新连接数: 200

看完这几个例子，OGNL 的核心逻辑你应该感受到了：把 getXxx().getYyy() 这一串 Java 调用，压缩成 xxx.yyy 的点号路径表达式，引擎在运行时通过反射帮你补齐 getter 调用。

本质上，OGNL 给你提供了一种「用字符串写 Java 代码」的能力。表达式就是一段脚本，只不过写得像属性路径而不像传统代码。

四、Arthas + ognl：线上调试这才是完全体

前面是热身，现在我们回到 Arthas。

在 Arthas 里，ognl 命令把表达式引擎直接接入了 JVM 运行时——你不重启、不加日志、不改代码，就能访问目标进程里的任何类、任何对象、任何方法。

Arthas ognl 命令：Arthas 内置的 OGNL 表达式执行工具，通过 ognl '<表达式>' 一行命令即可在线访问目标 JVM 中任意类的静态字段、调用静态方法、动态构造集合对象。你可以把它理解为「插在运行中 JVM 上的 SQL 查询终端」——只不过查的不是数据库，是内存里的对象。

Arthas ognl 的基本语法：

ognl '<OGNL表达式>'

表达式里用 @类全限定名@字段/方法 的方式访问静态成员。

4.1 访问静态字段

线上排查时经常想知道某个类的静态状态——比如某个配置类的常量值、某个单例的内部状态。ognl 一行搞定：

$ ognl '@com.ttk.MyConfig@MAX_RETRY'
@Integer[5]

输出告诉你 MAX_RETRY 当前值是 5。不用翻代码、不用找配置文件，当场看当场确认。

如果字段本身是一个复杂对象，ognl 会递归展开它的内部结构，输出比 toString() 详细得多：

$ ognl '@java.util.Locale@getDefault()'
@Locale[
    language=@String[zh],
    country=@String[CN],
    ...
]

4.2 调用静态方法

ognl 不只是读，也可以执行。比如直接调用 System.out.println 往线上进程的标准输出打一行内容：

$ ognl '@java.lang.System@out.println("ognl test from arthas")'
ognl test from arthas

这比你在代码里加一行 System.out.println 再重新打包部署快了不知道多少倍。

更实用的场景——调用工具方法做即时计算：

$ ognl '@java.lang.System@getProperty("java.version")'
@String[11.0.21]

$ ognl '@java.lang.String@format("env: %s, port: %d", "prod", 8080)'
@String[env: prod, port: 8080]

$ ognl '@java.lang.Thread@currentThread().getName()'
@String[arthas-command-execute]

4.3 动态构造数据——ognl 的真正威力

如果只是访问静态字段和调用静态方法，那ognl 还只能算「方便」。它真正厉害的地方在于支持 # 开头的临时变量和多语句组合——你可以在表达式里声明变量、赋值、构造集合，最后返回一个组合结果。

来看几个典型场景：

$ ognl '#v1=@java.lang.System@getProperty("java.version"), #v2=@java.lang.System@getProperty("user.dir"), {#v1, #v2}'
@ArrayList[
    @String[11.0.21],
    @String[/opt/app],
]

$ ognl '#list=new java.util.ArrayList(), #list.add("arthas"), #list.add("ognl"), #list.add("debug"), #list'
@ArrayList[
    @String[arthas],
    @String[ognl],
    @String[debug],
]

$ ognl '#map=new java.util.HashMap(), #map.put("tool", "arthas"), #map.put("cmd", "ognl"), #map'
@HashMap[
    tool=@String[arthas],
    cmd=@String[ognl],
]

这种动态构造能力意味着什么？你可以在不重启的情况下，在线上 JVM 里当场造出测试数据、拼装参数、验证逻辑——排查复杂业务 bug 的时候，这简直就是降维打击。

举个例子：线上一个订单处理逻辑的结果异常，你怀疑是某个中间步骤的计算参数传错了。watch 只能看到入参和返回值，中间过程全程黑盒。这时候用 ognl 就能直接复现那一段计算——在 Arthas 里用 #变量 拼出输入参数，调目标方法拿到中间结果，当场确认是上游传的值有问题还是本地逻辑有 bug。不用加一行日志，不用重启，十分钟定位。

可能有人会问：ognl 表达式里 # 变量和 @ 分别代表什么？

@ 用来引用类—— @全限定类名@字段 访问静态成员，@全限定类名@方法(参数) 调用静态方法。# 用来声明临时变量—— #varName=value 定义后可以在同一个表达式里继续使用，ognl 会把最后一个表达式的值作为整体返回值。记住这个就够了：@ 找人，# 记东西。

五、ognl 和 vmtool，到底什么关系？

如果你看过本系列的 vmtool 篇，可能会觉得这两个命令有点重叠——都能在运行时访问对象、调用方法。确实重叠，但定位不同。

对比维度	vmtool	ognl
使用方式	交互式面板，逐级点选类→方法→实例	一行表达式字符串，直接写到目标
核心能力	强制调用实例方法、获取 Spring Bean 并执行	任意对象导航、表达式运算、动态构造数据
灵活度	操作路径固定（点选 → 执行）	极高（表达式里可以组合变量、条件、构造集合）
上手门槛	低，有菜单引导	中，需要记住 @ 和 # 语法
适合场景	快速调一个具体方法看结果	复杂表达式求值、构造测试数据、一次拿多个来源的数据

说人话就是：vmtool 是遥控器，ognl 是命令行。遥控器按几个键就能操作，但能做的事有限；命令行上手要记语法，但能力边界远大于遥控器。

使用场景上可以这样区分：需要快速调一个方法看返回值，用 vmtool 点两下就完事；需要组合多个数据来源、拼装计算或者动态构造参数，直接上 ognl 表达式。

总结

OGNL 本质上就是把 Java 调用链变成了路径表达式——config.env 和 config.getEnv() 写的是一回事，差别只是谁来执行、什么时候执行。Arthas ognl 表达式的威力在于，它把这种能力无缝接入了线上 JVM，让你不重启就能「当场写代码、当场看结果」。

说真的，watch 和 trace 能帮你定位 90% 的问题，但剩下那 10% 需要你「当场操作、当场计算」的场景，ognl 是你的唯一解。这也解释了为什么入门教程很少提它——它不是入门工具，它是你排查能力到天花板之后的破壁锤。

---

Arthas 系列的最后一篇（下一篇），我会回到 Arthas 的底层：字节码增强技术原理。我们用了这么久的热更新、动态 watch、甚至 mc+retransform，背后的 Java Agent 和字节码改写到底是怎么做到的？敬请期待。

---

我是程序员天天困，持续分享编程干货。觉得有用的话记得点赞收藏和关注~也欢迎在评论区聊聊：你用 Arthas 排查过最头疼的问题是什么，ognl 帮你解决了吗？