迁移至macOS后Tomcat项目无法创建MySQL连接，报空指针异常

刚从Windows转macOS踩过这个MySQL连接的坑！结合你描述的报错（Could not create connection to database server+java.lang.NullPointerException at com.mysql.jdbc.ConnectionImpl.getServerCharset），大概率是版本兼容或配置细节问题，给你几个实操排查方向：

1. 优先排查MySQL与JDBC驱动的版本兼容性 #

这是最常见的诱因！Windows上用的MySQL版本（比如5.x）和你macOS上新装的版本（大概率是8.x）差异大，而你照搬的旧connector.jar（5.x驱动）完全适配不了8.x的MySQL协议，直接导致getServerCharset方法空指针。

解决方案：

• 先确认macOS上的MySQL版本：终端执行 mysql --version
• 下载对应版本的Connector/J驱动（MySQL 8.x对应mysql-connector-java-8.0.x.jar）
• 替换项目WEB-INF/lib下的旧驱动，同时删除Tomcatlib目录里可能存在的旧驱动（避免冲突）
• 更新context.xml里的驱动类名：把com.mysql.jdbc.Driver改成com.mysql.cj.jdbc.Driver（旧类名在8.x驱动中已废弃）

2. 修正MySQL连接URL的必填参数 #

MySQL 8.x强制要求指定时区，且部分环境需要开启公钥检索，而Windows上的旧版本可能没这个限制。你需要在context.xml的URL中补充这些参数：

正确的URL示例：

url="jdbc:mysql://localhost:3306/web_student_tracker?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true"

• serverTimezone=UTC：解决时区不匹配的报错
• allowPublicKeyRetrieval=true：解决macOS环境下公钥检索失败的问题

3. 确认MySQL服务状态与本地连接权限 #

macOS上MySQL默认可能未启动，或者root用户的本地连接权限和Windows不同：

• 检查服务状态：打开系统偏好设置→MySQL，确认服务是"Running"状态；或者终端执行 brew services start mysql（如果你用Homebrew安装的MySQL）
• 测试本地连接：终端执行 mysql -u root -p，输入密码能成功登录说明服务正常；如果登录失败，可能需要重置root密码（macOS新安装MySQL的初始密码可能存在临时文件中）

4. 检查context.xml的Resource配置完整性 #

确保你的Resource配置没有遗漏关键属性，完整示例参考：

<Context>
    <Resource 
        name="jdbc/web_student_tracker" 
        auth="Container" 
        type="javax.sql.DataSource"
        maxTotal="100" 
        maxIdle="30" 
        maxWaitMillis="10000"
        username="root" 
        password="你的macOS MySQL root密码"
        driverClassName="com.mysql.cj.jdbc.Driver"
        url="jdbc:mysql://localhost:3306/web_student_tracker?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true"
    />
</Context>

重点确认：username/password是否和macOS上的MySQL一致，driverClassName是否更新为新驱动类。

按这个顺序排查，一般都能解决问题！我当时就是因为驱动版本不兼容加时区参数缺失踩的坑，调整后就正常连接了。

内容的提问来源于stack exchange，提问作者Gönczöl Armand