JDBC URL 必须严格匹配目标数据库协议格式，任何字符错误都会导致连接失败；不同数据库对协议头、分隔符、参数名及大小写有硬性要求，关键参数如 characterEncoding、serverTimezone 等不可省略。
JDBC URL 必须严格匹配目标数据库的协议格式，填错一个字符（比如漏掉斜杠、写错冒号位置）就会直接报 java.sql.SQLException: No suitable driver 或连接超时。
不同数据库的JDBC URL核心结构差异
URL不是“套模板”就能通，每个数据库驱动对协议头、分隔符、参数键名都有硬性要求。比如：
-
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC：MySQL 要求useSSL和serverTimezone用小写，且必须用&连接参数 -
jdbc:postgresql://localhost:5432/mydb?currentSchema=public：PostgreSQL 的 schema 参数名是currentSchema，不是schema -
jdbc:dm://localhost:5236/?SCHEMA=test：达梦（DM8）的SCHEMA必须全大写，且不能跟在数据库名后，要作为查询参数 -
jdbc:h2:~/test：H2 Embedded 模式下不能加.mv.db后缀，也不能写成jdbc:h2:~/test.mv.db -
jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=myproj&accessId=xxx&accessKey=yyy：MaxCompute 的accessId和accessKey是必填项，且 URL 中不能省略https://和完整 endpoint
URL里哪些参数不能省，哪些能省
很多新手以为“主机+端口+库名”就够了，其实关键参数漏掉会导致连接成功但查不到表、时区错乱、中文乱码甚至权限拒绝：
- 必须显式指定的：
characterEncoding（如characterEncoding=utf8），否则 MySQL/Oracle 等默认用 latin1，中文全变问号 - 必须显式指定的：
serverTimezone（如serverTimezone=Asia/Shanghai），否则 MySQL 8.0+ 会因时区不匹配拒绝连接 - 必须显式指定的：
AUTO_SERVER=TRUE（H2），否则多进程访问时抛Database is already in use - 可省略但建议写的：
useUnicode=true（配合characterEncoding才生效） - 可省略但高危：
sslMode=DISABLED（PostgreSQL）、useSSL=false（MySQL），生产环境不应禁用，但本地调试常需显式关掉，否则连不上
URL测试失败时，先看错误信息里暴露的是哪一层
DBeaver 的“测试连接”按钮背后是分层校验，错误信息直接指明问题在哪一环：
- 报
Connection refused或Network is unreachable→ 网络层：检查 IP 是否写错、端口是否监听（telnet host port）、防火墙是否放行 - 报
Access denied for user→ 认证层：用户名密码错，或用户没被授权从该 host 连接（如 MySQL 的'user'@'%'vs'user'@'localhost'） - 报
Unknown database 'xxx'→ 会话层：URL 里的库名不存在，或用户无权访问该库（注意：有些数据库如 H2、SQLite 不强制要求库名存在） - 报
No suitable driver→ 驱动层：JDBC URL 协议头（jdbc:xxx）和你挂载的驱动类名（如com.mysql.cj.jdbc.Driver）不匹配，或驱动 jar 包没加载成功
IoTDB、Excel 这类非标数据库的 URL 特别容易踩坑
它们不像 MySQL 那样有统一规范，URL 写法高度依赖驱动实现，稍不注意就白连：
- IoTDB 表模型必须加
?sql_dialect=table，否则 DBeaver 只能看到树结构，查不到表；URL 写成jdbc:iotdb://127.0.0.1:6667/?sql_dialect=table - Excel（xlSql）路径必须用正斜杠且转义空格，Windows 下写成
jdbc:xls://C:/Users/John%20Doe/data.xlsx，不能用反斜杠或中文路径 - GBase 的 URL 必须带端口号，
jdbc:gbase://127.0.0.1/testdb会失败，必须写jdbc:gbase://127.0.0.1:5258/testdb - YashanDB 的 URL 模板是
jdbc:yasdb://host:port/yasdb，最后的/yasdb是必需路径段，不是数据库名
URL 是 JDBC 连接的入口钥匙，它不接受模糊匹配。驱动类名、协议头、主机端口、路径段、查询参数——每个位置都可能是单点故障。调不通时，不要反复重试，先复制报错信息里出现的完整 URL，逐段比对官方文档的示例，尤其是大小写、斜杠数量、等号前后有没有空格。
