Mac电脑装Spring Boot环境一直报错怎么解决

浅敏酱_6056

浅敏酱_6056

2026-08-07

664人浏览

原创

Mac上Spring Boot环境报错多因底层依赖不兼容或配置冲突,常见问题包括Maven版本与IDEA不兼容(建议降级至3.8.1)、JDK版本不匹配(需与Spring Boot版本对应)、端口占用(可用lsof+kill或--server.port临时解决)、数据库连接权限及URL参数错误(如useSSL=false、时区配置)。

mac电脑装spring boot环境一直报错怎么解决

Mac 上配置 Spring Boot 环境报错,多数不是 Spring Boot 本身的问题,而是底层依赖环境不兼容或配置冲突导致的。常见报错集中在 Maven 版本、JDK 兼容性、端口占用、数据库连接、Docker 插件等环节。下面分几类高频问题给出直接可操作的解决路径。

检查 Maven 版本是否与 IDEA 兼容

IntelliJ IDEA 内置 Maven 嵌入器对高版本(如 3.8.6+)支持不稳定,容易触发 java.lang.NoSuchMethodError: org.apache.maven.model.validation.DefaultModelValidator.() 类似错误。

  • 推荐降级到 Maven 3.8.1(经验证最稳定),下载地址:apache-maven-3.8.1-bin.tar.gz
  • 解压后修改 ~/.zshrc(或 ~/.bash_profile):
    export MAVEN_HOME=/path/to/apache-maven-3.8.1
    export PATH=$MAVEN_HOME/bin:$PATH
  • 在 IDEA → Preferences → Build → Maven 中,把 Maven home path 指向新路径,勾选 Use settings file 并指定 $MAVEN_HOME/conf/settings.xml

确认 JDK 版本与项目要求匹配

Spring Boot 3.x 要求 JDK 17+,但若项目用的是 Spring Boot 2.7.x,却装了 JDK 21,就可能报 无效的目标发行版: 17 或编译失败。

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载
  • 终端执行 java -version 和 mvn -v,确认 JDK 和 Maven 使用的是同一套 Java(echo $JAVA_HOME 应指向 JDK 17 安装路径)
  • 在 IDEA → Project Structure → Project Settings → Project 中,设置 Project SDK 和 Project language level 一致(如都为 17)
  • pom.xml 中显式声明编译插件目标版本(尤其多 JDK 共存时):
    <plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><source>17</source><target>17</target></configuration></plugin>

处理启动时 “Port 8080 was already in use”

Mac 上常因残留进程、Docker 容器、或其他 Java 应用(如旧版 Tomcat)占着 8080,导致 Spring Boot 启动失败。

  • 查占用:终端运行 lsof -i :8080,得到 PID 后用 kill -9 PID 强制结束
  • 临时换端口启动(不改配置):
    • IDEA Run Configuration → Program arguments 输入:--server.port=8081
    • 命令行运行:java -jar your-app.jar --server.port=8081
  • 永久修改:在 src/main/resources/application.properties 加一行:server.port=8081

修复数据库连接类报错(如 Access denied for user 'root'@'localhost')

即使 MySQL 正常运行,Spring Boot 仍连不上,大概率是权限或连接参数问题。

  • 进 MySQL 终端执行授权(假设密码是 123456):
    ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';
    FLUSH PRIVILEGES;
  • 检查 application.properties 是否漏写 useSSL=false 和时区(MySQL 8+ 必须):
    spring.datasource.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
  • 确保已引入驱动依赖(Spring Boot 3.x 用 mysql-java-connector-j,非 mysql-connector-java)

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2811

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

497

25

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

20

17

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

2026.11.02

20

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习