从Install4J 7迁移至10后Jenkins构建失败求助

核心问题分析 #

IDE能正常构建是因为读取了当前用户目录下的install4jCommon.xml许可证配置，但Jenkins流水线通常以jenkins系统用户运行，无法读取本地用户的配置；另外，当前Maven插件配置未显式指定许可证，导致命令行构建时无法获取浮动许可证。

具体解决步骤 #

1. 直接在Maven插件中指定浮动许可证 #

修改install4j-maven-plugin的配置，添加<licenseKey>参数，强制插件使用浮动许可证，无需依赖用户目录配置：

<plugin>
    <groupId>org.sonatype.install4j</groupId>
    <artifactId>install4j-maven-plugin</artifactId>
    <executions>
        <execution>
            <id>install4j-regular-build</id>
            <phase>validate</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <projectFile>misc/install4j/regular.install4j</projectFile>
                <winKeystorePassword>SECRETREMOVED</winKeystorePassword>
                <!-- 添加浮动许可证配置 -->
                <licenseKey>FLOAT:OURHOSTNAME:11862</licenseKey>
                <jvmArguments>
                    <arg>-Dinstall4j.connectTimeout=20000</arg>
                    <arg>-Dinstall4j.readTimeout=20000</arg>
                    <arg>-Dinstall4j.counterSignRetry=20</arg>
                    <arg>-Dinstall4j.timestampUrl=${signing.timestamp-server}</arg>
                </jvmArguments>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 确保Jenkins用户能访问许可证服务器 #

• 在Jenkins服务器上执行以下命令，测试网络连通性：

  telnet OURHOSTNAME 11862
  # 或用nc测试
  nc -zv OURHOSTNAME 11862
  

• 如果连接失败，检查防火墙规则、网络策略，确保Jenkins服务器能访问许可证服务器的11862端口。

3. 同步Jenkins用户的install4j配置文件 #

如果不想在插件中硬编码许可证，可将本地的~/.install4j/install4jCommon.xml复制到Jenkins用户的主目录下（通常是/var/lib/jenkins/.install4j/），确保文件权限为jenkins用户可读。

4. 验证命令行构建可行性 #

在Jenkins服务器上切换到jenkins用户，直接运行install4j命令行工具测试：

su - jenkins
install4jc -L FLOAT:OURHOSTNAME:11862 -p misc/install4j/regular.install4j

如果此命令成功，说明许可证配置和网络没问题，问题出在Maven插件的调用逻辑；如果失败，根据报错信息排查许可证服务器或权限问题。

5. 确认插件与install4j版本兼容性 #

当前使用的install4j-maven-plugin:1.1.2是否适配install4j 10.0.6？可以升级到插件的最新稳定版，避免版本不兼容导致的问题。

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