arthas/site/docs/doc/faq.md

# FAQ

::: tip
不在本列表里的问题，请到 issue 里搜索。 [https://github.com/alibaba/arthas/issues](https://github.com/alibaba/arthas/issues)
:::

### 日志文件在哪里？

日志文件路径： `~/logs/arthas/arthas.log`

### telnet: connect to address 127.0.0.1: Connection refused

1. 检查日志 `~/logs/arthas/arthas.log`
2. 检查`as.sh`/`arthas-boot.jar` 的启动参数，是否指定了特定的`port`
3. 用`netstat` 检查`LISTEN 3658` 端口的进程，确认它是`java`进程，并且是想要诊断的进程
4. 如果`LISTEN 3658` 端口的进程不是 `java` 进程，则`3658`端口已经被占用。需要在`as.sh`/`arthas-boot.jar` 的启动参数指定其它端口。
5. 确认进程和端口后，尝试用`telnet 127.0.0.1 3658`去连接

本质上`arthas`会在应用java进程内启动一个`tcp server`，然后使用`telnet`去连接它。

1. 可能端口不匹配
2. 可能进程本身已经挂起，不能接受新连接

如果Arthas 日志里有 `Arthas server already bind.`

1. 说明`Arthas server`曾经启动过，检查目标进程打开的文件描述符。如果是`linux`环境，可以去 `/proc/$pid/fd` 下面，使用`ls -alh | grep arthas`，检查进程是否已加载`arthas`相关的 jar 包。
2. 如果没有，那么可能已启动`arthas`的是其它进程，也可能应用已经重启过了。

### Arthas attach 之后对原进程性能有多大的影响

[https://github.com/alibaba/arthas/issues/44](https://github.com/alibaba/arthas/issues/44)

### target process not responding or HotSpot VM not loaded

com.sun.tools.attach.AttachNotSupportedException: Unable to open socket file: target process not responding or HotSpot VM not loaded

1. 检查当前用户和目标 java 进程是否一致。如果不一致，则切换到同一用户。JVM 只能 attach 同样用户下的 java 进程。
2. 尝试使用 `jstack -l $pid`，如果进程没有反应，则说明进程可能假死，无法响应 JVM attach 信号。所以同样基于 attach 机制的 Arthas 无法工作。尝试使用`jmap` heapdump 后分析。
3. 尝试按[quick-start](quick-start.md)里的方式 attach math-game。
4. 更多情况参考： [https://github.com/alibaba/arthas/issues/347](https://github.com/alibaba/arthas/issues/347)

### trace/watch 等命令能否增强 jdk 里的类？

默认情况下会过滤掉`java.`开头的类和被`BootStrap ClassLoader`加载的类。可以通过参数开启。

```bash
options unsafe true
```

更多参考 [options](options.md)

::: tip
通过 java.lang.instrument.Instrumentation#appendToBootstrapClassLoaderSearch append 到`Bootstrap ClassLoader`的 jar 包需要开启 unsafe。
:::

### 怎么以`json`格式查看结果

```bash
options json-format true
```

更多参考 [options](options.md)

### Arthas 能否跟踪 native 函数

不能。

### 能不能查看内存里某个变量的值

1. 可以使用[`vmtool`](vmtool.md)命令。
2. 可以用一些技巧，用[`tt`](tt.md)命令拦截到对象，或者从静态函数里取到对象。

### 方法同名过滤

同名方法过滤可以通过匹配表达式,可以使用[表达式核心变量](advice-class.md)中所有变量作为已知条件,可以通过判断参数个数`params.length ==1`, 参数类型`params[0] instanceof java.lang.Integer`、返回值类型 `returnObj instanceof java.util.List` 等等一种或者多种组合进行过滤。

可以使用 `-v` 查看观察匹配表达式的执行结果 [https://github.com/alibaba/arthas/issues/1348](https://github.com/alibaba/arthas/issues/1348)

例子[math-game](quick-start.md)

```bash
watch demo.MathGame primeFactors '{params,returnObj,throwExp}' 'params.length >0 && returnObj instanceof java.util.List' -v
```

### 怎么 watch、trace 构造函数 ？

```bash
watch demo.MathGame <init> '{params,returnObj,throwExp}' -v
```

### 怎样 watch、trace 内部类？

在 JVM 规范里内部类的格式是`OuterClass$InnerClass`。

```bash
watch OuterClass$InnerClass
```

### 是否支持 watch、trace lambda 类？

对于lambda生成的类，会跳过处理，因为 JVM 本身限制对 lambda 生成的类做增强。

- [https://github.com/alibaba/arthas/issues/1225](https://github.com/alibaba/arthas/issues/1225)

### 输入中文/Unicode 字符

把中文/Unicode 字符转为`\u`表示方法：

```bash
ognl '@java.lang.System@out.println("Hello \u4e2d\u6587")'
```

### java.lang.ClassFormatError: null、skywalking arthas 兼容使用

当出现这个错误日志`java.lang.ClassFormatError: null`,通常情况下都是被其他字节码工具修改过与 arthas 修改字节码不兼容。

比如: 使用 skywalking V8.1.0 以下版本 [无法 trace、watch 被 skywalking agent 增强过的类](https://github.com/alibaba/arthas/issues/1141), V8.1.0 以上版本可以兼容使用,更多参考 skywalking 配置 [skywalking compatible with other javaagent bytecode processing](https://github.com/apache/skywalking/blob/master/docs/en/FAQ/Compatible-with-other-javaagent-bytecode-processing.md#)。

#### class redefinition failed: attempted to change the schema (add/remove fields)

参考： [https://github.com/alibaba/arthas/issues/2165](https://github.com/alibaba/arthas/issues/2165)

### Arthas 能不能离线使用

可以。下载全量包解压即可，参考: [下载](download.md)。

### Arthas 怎么使用指定版本，不使用自动升级版本

1. 启动 `as.sh`/`arthas-boot.jar`时，可以用 `--use-version` 参数指定。
2. 下载全量包，解压后，`cd`到arthas目录启动，这种情况会使用当前目录下的版本。

### Attach docker/k8s 里的 pid 为 1 的进程失败

参考： [https://github.com/alibaba/arthas/issues/362#issuecomment-448185416](https://github.com/alibaba/arthas/issues/362#issuecomment-448185416)

### 为什么下载了新版本的 Arthas，连接的却是旧版本？

比如启动的 `as.sh/arthas-boot.jar` 版本是 3.5._ 的，但是连接上之后，打印的 arthas 版本是 3.4._ 的。

可能是之前使用旧版本的 arthas 诊断过目标进程。可以先执行`stop`停止掉旧版本的 arthas，再重新使用新版本 attach。

### 在ognl表达式中获取到 spring bean cglib 对象，但是 field 是 null

参考：

- [https://github.com/alibaba/arthas/issues/1802](https://github.com/alibaba/arthas/issues/1802)
- [https://github.com/alibaba/arthas/issues/1424](https://github.com/alibaba/arthas/issues/1424)