当前位置：首页 > news >正文

Arthas 定位 SpringBoot 接口超时问题操作指南

news 2026/6/1 6:35:18

🎁 福利时间

如果你正在备战面试或者想要学习其他知识，给大家推荐一个宝藏知识库，作者整理了一些列 Java 程序员需要掌握的核心知识，有需要的自取不谢。

知识库地址：https://farerboy.com/

一、Arthas 简介

Arthas 是 Alibaba 开源的 Java 诊断工具，它可以帮助开发者快速定位和解决 Java 应用的各种问题，包括：

接口超时
内存泄漏
CPU 使用率高
线程阻塞
类加载问题

Arthas 提供了丰富的命令，可以实时查看应用的运行状态，进行方法执行跟踪，分析调用链路等。

二、安装与启动

2.1 安装 Arthas

# 下载 Arthascurl-Ohttps://arthas.aliyun.com/arthas-boot.jar# 启动 Arthasjava-jararthas-boot.jar

2.2 连接到 SpringBoot 应用

运行java -jar arthas-boot.jar后，会列出当前运行的 Java 进程，选择要诊断的 SpringBoot 应用进程编号即可连接。

[INFO] arthas-boot version: 3.6.7 [INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER. * [1]: 12345 com.example.Application [2]: 67890 org.apache.catalina.startup.Bootstrap

输入对应的编号（如1），回车即可连接到目标应用。

三、接口超时定位步骤

3.1 步骤一：查看接口调用情况

使用trace命令跟踪接口方法的执行情况，查看每个方法的执行时间：

# 跟踪 Controller 中的方法trace com.example.controller.UserController getUser-n5# 跟踪 Service 层方法trace com.example.service.UserService getUserById-n5

3.2 步骤二：查看线程状态

使用thread命令查看线程状态，特别是阻塞的线程：

# 查看所有线程状态thread# 查看阻塞的线程thread-b# 查看 CPU 使用率高的线程thread-n3

3.3 步骤三：分析方法执行时间

使用profiler命令分析方法执行时间：

# 启动 profilerprofiler start# 等待一段时间后停止 profilerprofiler stop# 查看火焰图profiler stop--formathtml

3.4 步骤四：查看方法调用栈

使用stack命令查看方法的调用栈：

# 查看方法的调用栈stack com.example.service.UserService getUserById

3.5 步骤五：查看 SQL 执行情况

如果接口超时与数据库操作有关，可以使用sql命令查看 SQL 执行情况：

# 查看 SQL 执行情况sql

四、具体操作示例

4.1 示例一：定位 Controller 方法超时

假设我们有一个用户接口/api/user/{id}响应缓慢，我们可以通过以下步骤定位问题：

启动 Arthas 并连接到应用

跟踪 Controller 方法

trace com.example.controller.UserController getUser-n5

查看执行结果

`---ts=2023-04-01 10:00:00;thread_name=http-nio-8080-exec-1;id=123;is_daemon=false;priority=5;TCCL=org.springframework.boot.web.embedded.tomcat.TomcatEmbeddedWebappClassLoader@12345678 `---[1000ms] com.example.controller.UserController:getUser() +---[0ms] java.lang.String:valueOf() +---[500ms] com.example.service.UserService:getUserById() +---[0ms] com.example.controller.UserController:buildResponse()

从结果可以看出，UserService.getUserById()方法执行了 500ms，是导致接口超时的主要原因。

跟踪 Service 方法

trace com.example.service.UserService getUserById-n5

查看执行结果

`---ts=2023-04-01 10:00:00;thread_name=http-nio-8080-exec-1;id=123;is_daemon=false;priority=5;TCCL=org.springframework.boot.web.embedded.tomcat.TomcatEmbeddedWebappClassLoader@12345678 `---[500ms] com.example.service.UserService:getUserById() +---[0ms] com.example.dao.UserDao:findById() +---[450ms] java.sql.Statement:executeQuery() +---[0ms] com.example.service.UserService:convertToDTO()

从结果可以看出，java.sql.Statement:executeQuery()方法执行了 450ms，是导致 Service 方法超时的主要原因。

查看 SQL 执行情况
```
sql
```
查看是否有慢 SQL 执行。

4.2 示例二：定位线程阻塞问题

如果接口超时是由于线程阻塞引起的，可以通过以下步骤定位：

启动 Arthas 并连接到应用
查看阻塞的线程
```
thread-b
```
查看线程堆栈
```
thread123# 123 是线程 ID
```
分析阻塞原因
从线程堆栈中可以看出线程阻塞的原因，例如：
- 死锁
- 资源竞争
- 外部服务调用超时

五、高级分析技巧

5.1 使用 watch 命令查看方法参数和返回值

# 查看方法的参数和返回值watchcom.example.service.UserService getUserById'{params, returnObj}'-x2# 查看方法抛出的异常watchcom.example.service.UserService getUserById'{params, throwExp}'-e-x2

5.2 使用 tt 命令记录方法执行过程

# 记录方法执行过程tt-tcom.example.service.UserService getUserById# 查看记录的执行过程tt-l# 重放方法执行tt-p1000# 1000 是记录的 ID

5.3 使用 jad 命令反编译类

# 反编译类jad com.example.service.UserService# 反编译方法jad com.example.service.UserService getUserById

5.4 使用 classloader 命令查看类加载信息

# 查看类加载器信息classloader# 查看类的加载情况classloader-t

六、常见问题与解决方案

6.1 Arthas 连接失败

问题：运行java -jar arthas-boot.jar后，无法找到目标 SpringBoot 应用进程。

解决方案：

确保目标应用正在运行
确保使用与目标应用相同的用户运行 Arthas
确保目标应用的 JVM 参数中没有限制 Arthas 的连接

6.2 命令执行超时

问题：执行某些 Arthas 命令时出现超时。

解决方案：

减少命令的执行时间，例如使用-n参数限制执行次数
增加 Arthas 的超时时间，通过--timeout参数设置

6.3 无法查看 SQL 执行情况

问题：执行sql命令时，无法看到 SQL 执行情况。

解决方案：

确保应用使用了支持的数据库连接池，如 HikariCP、Druid 等
确保应用的 JDBC 驱动版本与 Arthas 兼容

七、最佳实践

定期监控：定期使用 Arthas 监控应用的运行状态，及时发现潜在问题。
问题定位：当接口出现超时问题时，按照本文介绍的步骤进行定位和分析。
性能优化：根据 Arthas 的分析结果，对应用进行性能优化，如：
- 优化 SQL 查询
- 减少外部服务调用时间
- 优化线程池配置
- 减少方法调用层级
学习和分享：学习 Arthas 的高级功能，与团队成员分享使用经验。