SQLInvalidAuthorizationSpecException表示数据库认证失败，主因是用户名密码错误、特殊字符未URL编码（如@需写为%40）、用户权限不足、主机限制或驱动与认证插件不兼容（如MySQL 8.0+的caching_sha2_password）。
Java 中 JDBC 连接数据库时遇到安全认证失败，最典型的异常是 SQLInvalidAuthorizationSpecException（也常作为 SQLException 的子类抛出）。它不是网络不通或驱动缺失，而是明确告诉你：**凭据无效或权限不足**。处理的关键不是“捕获后重试”，而是快速定位并修复认证环节的配置问题。
检查连接凭据与 URL 编码
用户名或密码错误是最常见原因，但容易被忽略的是特殊字符未编码：
- 若密码含
@、/、:、?等 URL 保留字符，必须用百分号编码，例如pass@123→pass%40123；否则 JDBC 解析 URL 时会把@当作 host 分隔符，导致实际传入的密码被截断。 - 确认代码中传入
DriverManager.getConnection(url, user, pass)的参数值，与数据库中创建用户时设置的完全一致（注意大小写、前后空格）。 - 避免硬编码：改用配置文件（如
application.properties）或环境变量读取账号密码，既安全又便于调试。
验证数据库用户状态与访问范围
登录成功 ≠ 能连上指定库。需人工登录数据库服务器核查：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
MySQL：执行
SELECT User, Host, account_locked FROM mysql.user WHERE User = 'your_user';，确认该用户存在、未锁定，且Host允许从应用所在机器连接（如'%'或具体 IP）。 -
PostgreSQL：运行
SELECT usename, passwd IS NOT NULL AS has_password, enabled FROM pg_shadow WHERE usename = 'your_user';，检查密码是否已设、账户是否启用。 - 即使能登录，也要确保用户对目标数据库有
CONNECT权限（PostgreSQL）或USAGE权限（MySQL），否则部分驱动会在初始化阶段直接报认证失败。
确认驱动版本与认证插件兼容性
尤其是 MySQL 8.0+ 默认使用 caching_sha2_password 插件，而老版驱动（如 5.1.x）不支持，会伪装成“认证失败”：
立即学习“Java免费学习笔记（深入）”；
- 优先升级驱动：MySQL 推荐使用
mysql-connector-java 8.0.33+；PostgreSQL 使用postgresql-42.7.0+。 - 若暂时无法升级驱动，可临时切换用户认证方式（MySQL）：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_new_pass'; FLUSH PRIVILEGES; - 连接 URL 中可显式指定认证插件（MySQL）：
jdbc:mysql://localhost:3306/db?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false（注意allowPublicKeyRetrieval=true是适配新插件的必要参数）。
启用详细日志定位真实原因
仅看异常消息往往不够。在 JDBC URL 中开启调试日志：
- MySQL：追加参数
&logger=com.mysql.cj.log.StandardLogger&profileSQL=true，控制台会输出完整的握手流程和认证响应。 - PostgreSQL：添加
&loggerLevel=TRACE，查看是否因pg_hba.conf拒绝了连接类型（如要求md5却收到password）。 - 捕获异常时打印完整堆栈和 SQLState：
System.err.println("SQLState: " + e.getSQLState() + ", Code: " + e.getErrorCode());
例如 MySQL 认证失败通常返回28000状态码，比泛化消息更可靠。
