某开发者Maven构建中Profile激活表达式未正常生效的排查

问题背景 #

我们维护的基于Maven构建的服务平台中，存在一个配置如下的Profile，预期仅在非Windows系统下激活：

<profile>
    <activation>
        <os>
            <family>!windows</family>
        </os>
    </activation>
    <build>
        <plugins>
            <!-- 包含Windows不支持的构建步骤 -->
        </plugins>
    </build>
</profile>

实际场景中，Windows 10（JDK 11.0.13）构建时该Profile未激活（符合预期），但Windows 11（JDK 11.0.18）构建时该Profile被错误激活，导致构建失败。Maven 3.8.8和3.9.1版本均存在此问题。

排查方向 #

1. 验证JDK返回的操作系统标识 #

Maven的OS家族判断依赖JDK提供的os.name系统属性，让Windows 11开发者运行以下代码，确认JDK返回值是否符合预期：

public class OsFamilyCheck {
    public static void main(String[] args) {
        String osName = System.getProperty("os.name");
        System.out.println("JDK os.name: " + osName);
        
        // 模拟Maven核心的OS家族判定逻辑（参考Maven Os类源码）
        String mavenOsFamily;
        if (osName.toLowerCase().contains("win")) {
            mavenOsFamily = "windows";
        } else if (osName.toLowerCase().contains("mac")) {
            mavenOsFamily = "mac";
        } else if (osName.toLowerCase().matches(".*(nix|nux|aix).*")) {
            mavenOsFamily = "unix";
        } else if (osName.toLowerCase().contains("sunos") || osName.toLowerCase().contains("solaris")) {
            mavenOsFamily = "sunos";
        } else {
            mavenOsFamily = osName.toLowerCase();
        }
        System.out.println("Maven识别的OS家族: " + mavenOsFamily);
    }
}

如果输出的Maven识别的OS家族不是windows，则会触发!windows的Profile激活条件。

2. 检查全局/用户级Maven配置 #

• 检查开发者本地的settings.xml文件（路径：~/.m2/settings.xml 或 Maven安装目录/conf/settings.xml），确认是否存在<activeProfiles>强制激活该问题Profile，或有自定义属性覆盖了OS判断逻辑。
• 执行mvn help:effective-settings查看最终生效的配置，排查是否有异常的Profile激活规则。

3. 清理项目缓存与本地配置 #

• 执行mvn clean install -U，强制清理target目录、更新依赖，避免旧缓存影响Profile激活逻辑。
• 检查项目根目录是否存在maven.config文件，确认其中是否包含-P参数强制激活了该Profile。

4. 对比系统属性差异 #

让Windows 11开发者执行mvn help:system，输出所有系统属性，重点对比os.name、os.version等与Windows 10环境的差异，确认是否存在属性值变化导致Maven判断错误。

5. 验证JDK版本影响 #

让Windows 11开发者临时切换到JDK 11.0.13（与Windows 10环境一致），重新构建项目：

• 如果切换后Profile激活恢复正常，说明是JDK 11.0.18对os.name的返回逻辑有变更，或该JDK版本与Maven存在兼容性问题。可进一步查阅对应JDK的版本变更日志确认细节。

内容的提问来源于stack exchange，提问作者David M. Karr