Java：JDBC连接完整通俗易懂指南（图文表格版）

JDBC 链接简单来说就是Java 程序连接数据库的“地址”和“通道”。它的全称是Java Database Connectivity (Java数据库连接)是一套让 Java 代码能和不同数据库如 MySQL、Oracle、PostgreSQL 等对话的标准 API应用程序编程接口由 SUN 公司制定规范各大数据库厂商实现底层驱动。通俗类比JDBC 相当于数据库通行证通讯管道连接字符串就是通行证密码告诉Java程序数据库在哪、走什么通讯规则、账号密码、附加校验规则。1. JDBC连接核心结构拆解通俗注解以MySQL8.x标准连接地址为例jdbc:mysql://localhost:3306/mydb?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf-8拆分完整组成补齐原有文档缺失的驱动协议细分规则全部表格化组成部分细分规则含义标准示例值必填与否顶层协议固定前缀jdbc:代表启用JDBC通讯规范所有数据库必须保留不可修改jdbc:必填数据库子协议区分数据库类型驱动识别标识mysql/oracle/postgresql各不相同mysql://必填主机Host数据库服务器IPlocalhost仅代表本机线上必须填写外网/内网IPlocalhost、127.0.0.1、192.168.3.105必填端口Port数据库监听端口每个数据库默认端口固定不可随意修改3306(MySQL)、1521(Oracle)必填业务库名连接目标业务数据库不是MySQL服务本身必须提前手动创建mydb、user_db、order_db必填扩展连接参数配置编码、时区、加密、超时、认证规则多个参数使用分隔?serverTimezoneAsia/Shanghai可选生产必加2. 主流数据库完整对照表补齐驱动类maven依赖生产可用原有文档缺失驱动类、适配版本、特殊语法整合为最全对照表区分老旧版本与新版本规避报错数据库类型JDBC连接地址完整驱动类默认端口适配场景MySQL8.xjdbc:mysql://localhost:3306/mydb?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltruecom.mysql.cj.jdbc.Driver新版3306主流生产环境、SpringBoot2.x/3.xMySQL5.xjdbc:mysql://localhost:3306/mydb?useSSLfalsecharacterEncodingutf-8com.mysql.jdbc.Driver旧版已废弃3306老旧遗留项目Oraclejdbc:oracle:thin:localhost:1521:xeoracle.jdbc.OracleDriver1521金融、国企老旧项目PostgreSQLjdbc:postgresql://localhost:5432/mydborg.postgresql.Driver5432云原生、大数据项目SQL Serverjdbc:sqlserver://localhost:1433;databaseNamemydbcom.microsoft.sqlserver.jdbc.SQLServerDriver1433传统Windows业务系统SQLitejdbc:sqlite:D:/db/mydb.dborg.sqlite.JDBC无端口本地轻量化单机项目避坑关键点MySQL8.x 禁止使用旧驱动com.mysql.jdbc.Driver会直接启动告警、连接失败必须带时区参数3. JDBC原生代码优化版修复旧代码缺陷3.1 原有代码存在问题强行编写Class.forName加载驱动JDBC4.0完全冗余未处理SQL异常、资源关闭不严谨时区参数错误线上时间错乱3.2 生产级精简代码import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class JdbcProdExample { public static void main(String[] args) { // 1. 生产标准链接地址 String url jdbc:mysql://localhost:3306/mydb?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf-8allowPublicKeyRetrievaltrue; String username root; String password root123456; // 2. JDBC4.0自动加载驱动无需手动Class.forName // 3. try-with-resources自动关闭连接杜绝连接泄露核心优化点 try (Connection conn DriverManager.getConnection(url, username, password); Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(SELECT name,id FROM users)) { // 遍历查询结果 while (rs.next()) { System.out.println(用户IDrs.getInt(id) 用户名 rs.getString(name)); } } catch (Exception e) { // 生产环境禁止直接打印堆栈需要日志输出 e.printStackTrace(); } } }4. SpringBoot全场景配置补充多环境废弃参数说明4.1 application.properties 标准生产配置# 数据库连接地址 spring.datasource.urljdbc:mysql://localhost:3306/mydb?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf-8allowPublicKeyRetrievaltrue # 账号密码 spring.datasource.usernameroot spring.datasource.passwordroot123456 # MySQL8固定驱动类禁止简写 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # 开启打印sql日志调试专用 logging.level.com.zaxxer.hikariDEBUG4.2 application.yml 标准生产配置spring: datasource: url: jdbc:mysql://localhost:3306/mydb?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf-8 username: root password: root123456 driver-class-name: com.mysql.cj.jdbc.Driver4.3 废弃参数补充高频踩坑废弃参数问题替代方案useLegacyDatetimeCodeMySQL8彻底废弃引发时间报错直接删除使用serverTimezone统一时区driverClassNamecom.mysql.jdbc.Driver过期驱动SpringBoot3直接启动失败替换为com.mysql.cj.jdbc.Driver5. MySQL连接参数完整版分类表格区分开发/生产扩充原有参数拆分必填参数、优化参数、故障修复参数适配线上生产参数名称详细作用适用环境serverTimezoneAsia/Shanghai指定东八区时区解决相差8小时、时间回显错误生产必填MySQL8全局useSSLfalse关闭SSL加密连接本地开发关闭外网公网必须开启true本地开发关闭线上生产开启characterEncodingutf-8统一通讯编码解决新增、查询中文乱码全环境必填allowPublicKeyRetrievaltrue