使用maven-site-plugin构建站点时，site.xml环境变量替换报错如何解决？

嘿，我碰到过这个问题！你遇到的报错根源在于maven-site-plugin默认不会直接解析site.xml里的环境变量占位符，而且这个插件在处理路径相关配置时，会把未解析的${}当成非法字符，所以才会抛出Illegal character in path的错误。下面给你两个靠谱的解决方案：

方案1：通过Maven属性中转环境变量 #

maven-site-plugin会正常解析Maven内置属性，所以我们可以先把环境变量映射成Maven属性，再在site.xml里使用这个属性：

1. 在项目的pom.xml中添加properties配置，将环境变量转成Maven属性：

<properties>
    <git.url>${env.git_url}</git.url>
</properties>

2. 然后在site.xml里替换原来的占位符为这个Maven属性：

<!-- 举个例子，比如在导航链接里使用 -->
<item name="Git仓库" href="${git.url}"/>

这样Maven会先把环境变量git_url注入到git.url属性中，再由maven-site-plugin解析这个属性完成替换。

方案2：用maven-resources-plugin预处理site.xml #

如果你的site.xml放在src/site/resources目录下，可以借助maven-resources-plugin在site插件执行前先完成占位符替换：

1. 在pom.xml的build节点下添加resources插件配置，开启文件过滤：

<build>
    <resources>
        <resource>
            <directory>src/site/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>**/site.xml</include>
            </includes>
        </resource>
    </resources>
</build>

2. （可选）如果site插件没有自动读取处理后的文件，你可以明确指定site目录：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-site-plugin</artifactId>
    <version>3.6</version>
    <configuration>
        <siteDirectory>${project.build.directory}/site/resources</siteDirectory>
    </configuration>
</plugin>

执行mvn site时，resources插件会先把site.xml里的${env.git_url}替换为实际的环境变量值，再交给site插件处理，就不会出现非法字符的问题了。

额外提醒 #

• 先确认环境变量git_url已经正确设置：Linux/macOS下执行echo $git_url，Windows下执行echo %git_url%，确保有合法的取值。
• 如果你的Git地址包含特殊字符（比如空格、&符号），记得在环境变量里做适当转义，或者在Maven属性中处理。

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