Linux环境下WildFly 24解析含分号的JDBC环境变量问题

针对你遇到的JDBC URL含分号导致的截断、启动失败或转义错误问题，以下几种方法可以解决：

方法1：正确设置环境变量并在配置中引用 #

1. 通过Shell导出带双引号的环境变量：

   export DATABASE_JDBC_URL="jdbc:sqlserver://sqlserver.c3klg5a2ws.us-east-1.rds.amazonaws.com:1433;DatabaseName=ejbca;encrypt=false"
   

   双引号会让Shell将整个URL作为单一变量值，不会拆分分号。
2. 在WildFly配置文件中引用环境变量：
   在standalone.xml（或对应环境的配置文件）的数据源配置里，用${env.DATABASE_JDBC_URL}引用变量：

   <datasource jndi-name="java:jboss/datasources/EjbcaDS" pool-name="EjbcaDS" enabled="true">
       <connection-url>${env.DATABASE_JDBC_URL}</connection-url>
       <!-- 驱动、用户名密码等其他配置 -->
   </datasource>
   

3. 直接启动WildFly：无需在启动命令中额外传递变量，Shell会将已导出的环境变量完整传递给WildFly进程。

方法2：启动时用单引号包裹JDBC URL参数 #

如果需要在启动命令中直接传递参数，用单引号包裹整个JDBC URL，避免Shell解析分号：

./standalone.sh -DDATABASE_JDBC_URL='jdbc:sqlserver://sqlserver.c3klg5a2ws.us-east-1.rds.amazonaws.com:1433;DatabaseName=ejbca;encrypt=false'

单引号内的内容会被完整作为系统属性值传递给WildFly，Java能直接识别正确的URL，不会出现转义符残留问题。

方法3：拆分JDBC URL参数为数据源属性 #

SQL Server的JDBC驱动支持将URL中的参数单独配置为数据源属性，彻底规避分号解析问题：
在standalone.xml的数据源配置中，仅保留基础连接地址，将DatabaseName、encrypt等参数拆分为独立的<property>：

<datasource jndi-name="java:jboss/datasources/EjbcaDS" pool-name="EjbcaDS" enabled="true">
    <connection-url>jdbc:sqlserver://sqlserver.c3klg5a2ws.us-east-1.rds.amazonaws.com:1433</connection-url>
    <driver>sqlserver</driver>
    <security>
        <user-name>${env.DATABASE_USER}</user-name>
        <password>${env.DATABASE_PASSWORD}</password>
    </security>
    <properties>
        <property name="DatabaseName" value="ejbca"/>
        <property name="encrypt" value="false"/>
    </properties>
    <!-- 连接验证配置 -->
    <validation>
        <check-valid-connection-sql value='SELECT 1;'/>
    </validation>
</datasource>

这种方式不仅解决了分号问题，还让配置结构更清晰易维护。

关于连接检查SQL的补充 #

你提到的SELECT 1;用单引号包裹生效的方式是正确的，在XML配置中，单引号可以避免解析器误将分号判定为标签分隔符，保持该写法即可。

内容的提问来源于stack exchange，提问作者Alex G.