看起来你遇到的问题很典型——尝试Instrument JDK内部的Xerces实现类，但TypeMatcher就是匹配不到对吧？我之前也碰到过类似的情况，给你几个排查方向和解决方案：

1. 先确认目标类是否真的被应用加载了 #

首先别着急调Instrumentation，先搞清楚你的应用实际用的是不是com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl。可以在应用代码里加一行日志验证：

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
System.out.println("实际使用的DocumentBuilder实现类：" + builder.getClass().getName());

如果输出不是这个类，那匹配失败就很正常了——比如有些环境下可能用的是其他XML解析器（比如Apache Xerces的非内部版本，或者其他厂商的实现）。

2. 解决Bootstrap类加载器的访问限制 #

com.sun.org.apache.xerces.internal这类属于JDK内部API，是由Bootstrap类加载器加载的，而OpenTelemetry Java Agent默认可能不会扫描Bootstrap类加载器中的类。你需要做两个配置：

• 启动Agent时添加参数：
  在启动应用的命令里，给Agent加上--include-bootstrap-classes参数，指定要扫描的内部类：

  java -javaagent:opentelemetry-javaagent.jar \
    -Dotel.javaagent.extensions=your-instrumentation.jar \
    --include-bootstrap-classes=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl \
    -jar your-app.jar
  

• 在Instrumentation模块中声明Bootstrap类依赖：
  如果是用Gradle/Maven构建你的Instrumentation模块，需要配置让插件识别这个类属于Bootstrap加载范围。比如Gradle的OpenTelemetry插件可以这么加：

  otelInstrumentation {
    bootstrapClasses = ["com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl"]
  }
  

3. 调整TypeMatcher的写法（加调试日志） #

有时候看起来正确的匹配器可能因为类名的细微差异失效，建议你把匹配器改成自定义实现，加上调试日志，看看Agent有没有扫描到这个类：

@Override
public ElementMatcher<TypeDescription> typeMatcher() {
    return typeDescription -> {
        String className = typeDescription.getName();
        // 打印扫描到的类，方便调试
        System.out.println("Agent扫描到的类：" + className);
        return "com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl".equals(className);
    };
}

同时开启Agent的调试日志，添加JVM参数-Dio.opentelemetry.javaagent.debug=true，这样能看到Agent加载Instrumentation和扫描类的详细过程，排查是否有加载失败的情况。

4. 确认Instrumentation是否正确注册 #

最后检查你的Instrumentation类有没有被Agent正确识别：

• 确保在你的Instrumentation模块的META-INF/services/io.opentelemetry.javaagent.extension.instrumentation.TypeInstrumentation文件中，添加了你的DocumentBuilderInstrumentation的全类名，比如：

  com.your.package.DocumentBuilderInstrumentation
  

  如果是用Gradle/Maven的自动服务注册插件，这个文件会自动生成，但如果是手动构建的话要自己加。

按照这几个步骤排查下来，应该能解决匹配不到的问题。

备注：内容来源于stack exchange，提问作者Meir Tolpin