Maven Profile 未激活导致依赖解析失败

问题现象

IDEA 中项目报"包不存在"错误，依赖明明在 pom.xml 中声明了，但就是无法解析。

根本原因

Profile 未激活导致依赖解析失败——这是 Maven 多环境配置中一个非常经典的"坑"。

具体原因：

• 父 POM（或当前 POM）中定义了多个 <profile>，比如 native、nativeTest 等
• 这些 profile 里可能通过 <pluginManagement> 或 <dependencies> 引入了特定依赖
• ~/.m2/settings.xml 中虽然配置了某些 profile 的激活条件，但 IDEA 的 Maven 插件并不会自动读取 settings.xml 中的激活配置
• 需要手动在 Maven 工具窗口中勾选对应的 profile

解决方案

在 IDEA 右侧 Maven 工具窗口中，手动勾选需要的 profile，然后点击刷新。

如何避免下次再遇到同样问题

1. 让 IDEA 自动激活特定 Profile（推荐）

在 pom.xml 的 <profiles> 中，为常用的 profile 添加 <activation> 标签：

<profile>
    <id>native</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    ...
</profile>

这样每次加载项目时，该 profile 会自动激活，无需手动勾选。

2. 在 IDEA 中持久化 Profile 激活状态

勾选 profile 后，IDEA 会记住当前项目的选择（存储在 .idea/workspace.xml 中），下次打开项目时应该保持勾选状态。

如果丢失，可以检查 .idea 目录是否被 Git 忽略或清理。

3. 通过 Maven 命令行参数统一激活

在 IDEA 的 Maven 运行配置中，添加 -P native 参数，确保编译、运行都使用该 profile。

4. 检查 settings.xml 的交互逻辑

~/.m2/settings.xml 中的 <activeProfiles> 对命令行 Maven 有效，但对 IDEA Maven 插件并非总是自动生效（取决于 IDEA 版本和设置）。

最稳妥的方式还是在 POM 中定义默认激活，或直接在 IDEA 中手动管理。

排查思路

如果发现"勾选 profile 后依赖就有了"，说明子模块中很可能有依赖被包裹在了某个 profile 中。检查自己的 pom.xml（不是父 POM），看看是否有类似结构：

<profiles>
    <profile>
        <id>my-profile</id>
        <dependencies>
            <dependency>
                <groupId>io.swagger.core.v3</groupId>
                <artifactId>swagger-annotations</artifactId>
            </dependency>
        </dependencies>
    </profile>
</profiles>

总结

此问题属于 Maven Profile 未激活导致的依赖缺失，而非 IDEA 项目识别故障。