添加SAXON-HE 11_5依赖导致Oracle Unified Directory无法启动求助

我们正在为Oracle Unified Directory（OUD）开发插件，需要在Java中添加XSLT支持，因此引入了SAXON-HE 11.5作为Maven依赖。插件在Eclipse中构建正常，但将更新后的JAR部署到OUD Proxy实例时，实例无法启动。排查发现：

• 添加依赖后JAR大小几乎翻倍
• 即使未实际使用XSLT功能，仅引入依赖就会导致启动失败
• 移除SAXON-HE依赖后，OUD实例可正常启动
• OUD启动时错误提示看似与PIN缺失相关，但日志中无其他异常信息

1. 排查类加载冲突 #

OUD本身大概率自带了XSLT处理库（比如Xalan或旧版本Saxon），引入SAXON-HE 11.5后会触发类加载冲突，这是这类插件部署失败的常见原因。可以这么验证和解决：

• 检查OUD安装目录下lib文件夹中的XSLT相关JAR（如xalan.jar、saxon*.jar），确认自带库版本
• 先尝试在Maven依赖中给SAXON-HE设置<scope>provided</scope>，测试OUD是否能正常启动——如果OUD自带的版本能满足你的XSLT需求，直接复用即可
• 若必须使用SAXON-HE 11.5，用**阴影JAR（Shaded JAR）**技术重命名SAXON-HE的包路径，彻底避免冲突。示例Maven配置：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals>
            <goal>shade</goal>
          </goals>
          <configuration>
            <relocations>
              <relocation>
                <pattern>net.sf.saxon</pattern>
                <shadedPattern>your.plugin.package.shaded.saxon</shadedPattern>
              </relocation>
            </relocations>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

2. 精简依赖，缩小JAR体积 #

SAXON-HE依赖包含大量未使用的类，不仅会让JAR体积翻倍，还可能触发OUD的类加载限制。可以做这些优化：

• 通过Maven的<exclusions>排除SAXON-HE的不必要传递依赖
• 用maven-shade-plugin的<includes>指定只打包插件实际用到的SAXON-HE类，比如：

<includes>
  <include>net.sf.saxon/xpath/**</include>
  <include>net.sf.saxon/xslt/**</include>
  <!-- 根据你实际调用的类调整路径 -->
</includes>

3. 深挖启动失败的真实原因 #

错误提示的PIN缺失大概率是类加载异常导致的间接表现，得拿到更详细的日志：

• 启用OUD的详细调试日志，添加JVM启动参数-Djava.util.logging.config.file=/path/to/your/logging.properties，在配置文件里把java.util.logging.ConsoleHandler.level和oracle.directory.server.level都设为FINEST，查看启动时的类加载轨迹
• 用jstack工具抓取OUD启动时的线程栈，定位卡住或抛出异常的具体位置
• 检查插件JAR的文件权限，确保和其他正常运行的插件权限一致

4. 尝试兼容版本的Saxon #

OUD可能对特定版本的Saxon有兼容性限制，试试降级到较旧的稳定版本（比如SAXON-HE 9.x系列），看是否能正常启动。

5. 复用OUD内置的XSLT功能 #

查一下OUD的官方文档，看看它是否提供了内置的XSLT处理API——比如通过oracle.directory.server下的工具类实现转换，这样完全不用引入外部依赖，从根源避免冲突。

内容的提问来源于stack exchange，提问作者jstack100