Mac系统IntelliJ下Spring Boot项目添加Jakarta依赖遇问题求助

一、先搞定Mac上Maven命令不识别的问题 #

• 先确认Maven是否安装：打开终端输入 mvn -v，如果提示命令不存在，直接用Homebrew安装：

  brew install maven
  

  安装完重启终端，再输入 mvn -v 确认版本正常输出。
• 要是已经装了但IntelliJ识别不到：
  1. 打开IntelliJ，进入 File > Settings > Build, Execution, Deployment > Build Tools > Maven
  2. 确认「Maven home directory」指向正确的安装路径（Homebrew装的一般是 /usr/local/Cellar/maven/{你的版本号}/libexec）
  3. 勾选「Use Maven wrapper」，用项目自带的mvnw脚本执行命令，避开系统环境的坑

二、修复spring-boot-maven-plugin标红问题 #

• 先检查pom.xml里的插件配置是否正确，标准Spring Boot项目的插件配置应该是这样：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

• 点击IntelliJ右侧Maven侧边栏的刷新图标（🔄），重新下载依赖
• 要是还标红，试试：
  1. 执行 File > Invalidate Caches... > Invalidate and Restart，清空缓存重启IDE
  2. 去本地Maven仓库（默认路径 ~/.m2/repository）找到spring-boot-maven-plugin的文件夹，删掉后再刷新Maven

三、确保表单验证依赖生效 #

• 你加的spring-boot-starter-validation依赖是对的，它已经包含了jakarta.validation-api及相关实现库，不用单独加Jakarta的依赖
• 依赖添加后按以下步骤验证：
  1. 在项目根目录终端执行 ./mvnw clean install（Mac下要加./）
  2. 或者在IntelliJ的Maven侧边栏，依次双击Lifecycle下的clean和install
  3. 写个测试：在实体类加@NotBlank这类验证注解，Controller方法参数前加@Valid，启动项目测试表单验证是否生效

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