在独立JAR应用中集成DB2许可证遇连接错误求助

我之前也碰到过完全一样的问题，核心原因是独立JAR的类加载机制默认无法识别嵌套在内部的许可证JAR，给你几个按优先级排序的解决方案：

方案1：运行时显式指定许可证JAR的类路径 #

这是最稳妥且容易排查的方法，不要把许可证JAR打包进你的应用JAR，而是在启动时通过类路径参数引入：

方式A：用-cp代替-jar启动 #

# Linux/macOS环境
java -cp "your-app.jar:db2jcc_license_cu.jar" com.your.package.YourMainClass

# Windows环境
java -cp "your-app.jar;db2jcc_license_cu.jar" com.your.package.YourMainClass

记得把com.your.package.YourMainClass替换成你JAR包中主类的全限定名。

方式B：通过MANIFEST.MF配置Class-Path #

如果坚持要用java -jar启动，可以修改应用JAR的MANIFEST.MF文件，添加Class-Path属性指向外部的许可证JAR：

Main-Class: com.your.package.YourMainClass
Class-Path: db2jcc_license_cu.jar

注意：

• Class-Path里的路径是相对于你执行java -jar命令的目录，所以要把db2jcc_license_cu.jar放在和你的应用JAR同一目录下；
• 多个依赖JAR之间用空格分隔，不要用冒号或分号。

方案2：将许可证JAR内容合并到应用JAR中 #

如果必须把许可证打包到应用JAR内部，可以解压db2jcc_license_cu.jar的所有文件（重点保留com/ibm/db2/jcc/license目录下的类文件），然后和你的应用类一起重新打包成最终的JAR。

比如用Maven的话，可以添加maven-dependency-plugin插件自动完成解压合并：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>unpack-license</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>com.ibm.db2</groupId>
                        <artifactId>db2jcc_license_cu</artifactId>
                        <version>4.21.29</version> <!-- 必须和你的db2jcc驱动版本一致 -->
                        <outputDirectory>${project.build.directory}/classes</outputDirectory>
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>

方案3：验证许可证JAR与驱动版本匹配 #

错误日志里显示你的JDBC驱动版本是4.21.29，必须确保db2jcc_license_cu.jar的版本和db2jcc.jar（或db2jcc4.jar）的版本完全一致，版本不匹配也会触发许可证无效的错误。

你可以通过以下命令查看JAR版本：

# 查看驱动版本
java -cp db2jcc.jar com.ibm.db2.jcc.DB2Jcc -version

# 查看许可证JAR版本
java -cp db2jcc_license_cu.jar com.ibm.db2.jcc.DB2JccLicense -version

额外验证点 #

• 确认你的连接URL是正确的Type 4连接格式：jdbc:db2://<server>:<port>/<schema_name>:progressiveStreaming=2;，这个格式没问题；
• 如果使用的是DB2 Connect Unlimited Edition for System z，确保已经完成许可证激活（通常运行激活工具后会生成有效的许可证类，但如果你已经有db2jcc_license_cu.jar，这一步可能已经完成）。

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