WildFly Maven Plugin中CLI脚本传递系统属性失败问题咨询

核心问题分析 #

wildfly-maven-plugin执行CLI脚本时，Maven进程的系统属性不会自动传递给WildFly容器实例。你需要明确配置插件，将指定的系统属性注入到容器的运行上下文，CLI脚本才能读取到对应值。

具体解决步骤 #

1. 修正pom.xml的插件配置 #

确保在wildfly-maven-plugin的package目标配置中，通过container/systemProperties节点明确声明要传递的系统属性。如果是通过Maven命令行传入参数，要保证插件内的属性值引用对应Maven变量。示例配置如下：

<plugin>
    <groupId>org.wildfly.plugins</groupId>
    <artifactId>wildfly-maven-plugin</artifactId>
    <version>2.2.0.Final</version> <!-- 匹配你的WildFly版本 -->
    <executions>
        <execution>
            <id>package-executable-jar</id>
            <goals>
                <goal>package</goal>
            </goals>
            <configuration>
                <filename>your-app-runner.jar</filename>
                <container>
                    <systemProperties>
                        <!-- 定义要传递给CLI的系统属性 -->
                        <property>
                            <name>db.url</name>
                            <value>${db.url}</value>
                        </property>
                        <property>
                            <name>db.user</name>
                            <value>${db.user}</value>
                        </property>
                        <property>
                            <name>db.password</name>
                            <value>${db.password}</value>
                        </property>
                    </systemProperties>
                </container>
                <scripts>
                    <script>src/main/wildfly/cli/setup-datasource.cli</script>
                </scripts>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 在CLI脚本中正确引用系统属性 #

不要使用/system-property=*:read-resource命令——这个命令读取的是WildFly配置文件（standalone.xml/domain.xml）中定义的服务器系统属性，而非你传递的JVM系统属性。正确方式是用${sys:属性名}直接引用JVM系统属性，示例CLI脚本：

# 添加Oracle驱动模块
module add --name=com.oracle.driver --resources=../lib/ojdbc8.jar --dependencies=javax.api,javax.transaction.api

# 配置数据源，直接引用传递的系统属性
data-source add \
    --name=OracleDS \
    --jndi-name=java:/OracleDS \
    --driver-name=com.oracle.driver \
    --connection-url=${sys:db.url} \
    --user-name=${sys:db.user} \
    --password=${sys:db.password} \
    --min-pool-size=5 \
    --max-pool-size=20

如果需要验证属性是否传递成功，可以在CLI脚本开头添加输出语句：

echo "当前DB URL: ${sys:db.url}"

打包时控制台会输出该值，确认属性传递状态。

3. 额外注意事项 #

• 确保wildfly-maven-plugin版本与你的WildFly版本兼容，避免版本不匹配导致的属性传递异常。
• 如果使用wildfly:run目标测试配置，同样需要在run目标的配置节点中添加systemProperties。
• 区分Maven属性与JVM系统属性：Maven属性用${属性名}引用，CLI中引用JVM系统属性必须加sys:前缀。

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