在IBM Rational Rhapsody插件中调用Guava Optional类报NoClassDefFoundError咨询

这个问题我之前帮人排查过，核心原因很明确：Rhapsody插件的类加载环境和普通Java应用的类路径完全不一样。当你用main方法运行时，你的IDE或者Java命令行已经把Guava的jar包加到了类路径里，但作为Rhapsody插件运行时，Rhapsody的自定义类加载器找不到Guava的类文件，所以抛出了NoClassDefFoundError。

下面给你几个可行的解决方案，按推荐程度排序：

1. 将Guava打包到插件Jar中（最可靠的独立方案） #

这种方法把Guava的类直接合并到你的插件Jar里，完全避免依赖外部路径，适合插件分发场景。如果用Maven构建，可以用maven-shade-plugin实现：

在你的pom.xml里添加插件配置：

<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>
            <artifactSet>
              <includes>
                <include>com.google.guava:guava</include>
              </includes>
            </artifactSet>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

执行mvn package后，生成的Jar包就包含了Guava的所有类，Rhapsody加载插件时就能直接找到Optional类了。

如果是手动打包，直接把Guava jar里的com/google/common/base目录下的文件复制到你的插件Jar对应的目录里即可。

2. 将Guava Jar放到Rhapsody的全局类路径 #

如果不需要插件独立分发，只是自己使用，可以把Guava的jar包放到Rhapsody的类路径目录中：

• 找到Rhapsody的安装目录，比如C:\Program Files\IBM\Rational Rhapsody\9.0.1
• 把Guava jar放到Java文件夹下（这个目录里的jar会被Rhapsody的类加载器自动加载）
• 重启Rhapsody，再加载插件就不会报错了

3. 配置插件的类路径（适合多依赖场景） #

如果你有多个外部依赖，不想打包到Jar里，也不想放到全局目录，可以在Rhapsody中直接配置插件的类路径：

1. 打开Rhapsody，点击Tools -> Add-Ins -> Manage Add-Ins
2. 找到你的插件，点击Properties
3. 在Classpath字段里添加Guava jar的绝对路径（多个路径用分号分隔）
4. 保存配置，重启Rhapsody生效

为什么Main方法能正常运行？ #

当你用main方法运行时，Java的系统类加载器会加载你IDE或命令行指定的所有依赖（包括Guava），而Rhapsody插件使用的是它自己的自定义类加载器，默认只加载Rhapsody自带的类和插件Jar里的类，不会继承系统类路径的依赖，这就是两者的关键区别。

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