企业官网建设流程全解析

有段时间没写这种“查资料三分钟、填坑半小时”的基础教程了。前两天一个做Java的同学找我，说照着网上的代码连本机MySQL，翻来覆去都是“Could not create connection to database server”。我远程瞟了一眼，发现他连驱动程序都是随手从某个资源站下载的旧版jar包，MySQL数据库却是8.0，驱动类名都变了，不报错才怪。这件事让我觉得有必要把“MySQL官网驱动下载”这件事彻底说透——包括Java开发天天用的jar包驱动（JDBC Connector/J），以及办公数据分析场景经常碰到的ODBC驱动。一次讲清下载入口、版本选择、配置验证和常见坑位，看完你至少能搞明白：驱动到底去哪下、下哪个版本、下载完怎么装、连不上怎么查。

这教程适合三类人：做Java后端开发、需要从Excel或BI工具连MySQL的数据分析人员、以及用Python的pyodbc访问MySQL的朋友。内容不涉及高深理论，全部按实际操作的顺序来。

1. 先搞清楚驱动是什么：JDBC与ODBC的适用边界

很多新手一上来就问“驱动下载”，但没想明白自己到底需要哪一种。MySQL官方提供两类常用的连接驱动，一个是给Java用的jar包驱动，另一个是给操作系统层软件用的ODBC驱动，两者原理、配置路径完全不同。

1.1 JDBC驱动（jar包）是什么，为什么Java项目离不开它

JDBC是Java数据库连接的标准接口，Java程序通过它就能以统一方式访问各种数据库。MySQL官方的JDBC实现叫Connector/J，打包出来就是一个jar文件，比如mysql-connector-j-8.0.33.jar。这个jar包本身是纯Java编写的，不区分操作系统，Windows、Linux、macOS都能用同一个文件，所以下载时官方会专门提供一个“Platform Independent”的分类。

在Java项目里，程序通过DriverManager加载驱动，再由驱动完成与MySQL服务器的通信协议解析。具体到代码层面，历史上驱动类名是com.mysql.jdbc.Driver，但在Connector/J 8.0版本开始改成了com.mysql.cj.jdbc.Driver。如果拿着旧教程里的类名去配置新驱动，就会直接报ClassNotFoundException。这是很多人第一个踩的坑。

连接地址也有差异。老版本的URL通常是jdbc:mysql://localhost:3306/数据库名，新版本往往需要追加时区和SSL参数，否则连接时会因为时区不明或SSL握手失败而报错。一个最常见的写法是这样的：jdbc:mysql://localhost:3306/数据库名?useSSL=false&serverTimezone=Asia/Shanghai。不是所有项目都必须带这些参数，但带上了能少很多麻烦。

1.2 ODBC驱动是什么，它和JDBC的定位完全不同

ODBC是微软提出的开放数据库连接标准，本质上是操作系统层面的数据库访问接口。MySQL官方的ODBC实现叫Connector/ODBC，安装后会以动态库形式（Windows上的DLL、Linux上的SO文件）注册到系统里，任何支持ODBC的软件都能直接调用，不限于Java。

典型的ODBC使用场景包括：Excel直接导入MySQL数据、Access连接后端数据库、Power BI拉取MySQL表、老式桌面管理系统对接MySQL、以及Python里的pyodbc库连接MySQL。换句话说，你不需要写Java代码，只要在系统里配置好ODBC数据源，这些软件就能像读本地文件一样读取MySQL数据。

因为ODBC驱动是带本地代码的动态库，所以下载时必须区分操作系统和位数，这一点比jar包复杂得多。后面会单独讲怎么选。

1.3 两种驱动怎么选：一张表说清

我的建议很简单：如果你是Java开发者，直接用jar包驱动；如果你是在Excel、Access、Power BI或者Python的pyodbc场景里连MySQL，那就老实装ODBC驱动。技术选型上不需要在两者之间纠结，它们本来就是给不同场景准备的。

2. 下载前必须确认的三件事：MySQL版本、JDK版本、系统位数

官网下载页只会让你选操作系统和版本号，不会替你做任何兼容性判断。如果不提前确认下面三件事，下载完基本都会后悔：轻则白下，重则连接报错查半天。

2.1 先确认MySQL数据库版本

这一步最基础也最容易被忽略。查版本的方式有很多：如果是命令行，直接输入mysql --version；如果已经进入MySQL客户端，执行select version();。常见结果无非是5.7.x或者8.0.x两种大版本。

驱动的兼容逻辑是这样的：新版驱动一般向下兼容老版本数据库，比如用Connector/J 8.0.x连接MySQL 5.7完全没问题。但反过来，用老版本驱动连接MySQL 8.0数据库就可能踩坑，最大的问题出现在认证方式上。MySQL 8.0默认使用了caching_sha2_password认证插件，老驱动的部分版本不支持这种认证方式，导致连接时报错。如果你手头的MySQL是8.0，建议直接选8.0.x系列的驱动，省心。

2.2 再确认JDK版本

MySQL官方对Connector/J的JDK版本要求写得很明确：Connector/J 8.0.x系列要求JDK 8及以上，兼容JDK 11、JDK 17这些新版本。如果你的项目还在用JDK 6或JDK 7，那就只能选择5.1.x系列的老驱动。

查看JDK版本就在命令行执行java -version。很多公司老项目里JDK版本常年不升级，这一点排查起来特别隐蔽。我有一次帮人看问题，代码、SQL、驱动全都正常，最后才发现对方的Tomcat跑在JDK 7上，手动引入的却是8.0的驱动jar包，加载阶段就失败。版本匹配这件事，真不是官网下载页能替你解决的。

2.3 最后确认系统位数和Office位数

jar包驱动是纯Java的，这一条可以忽略。但ODBC驱动必须重视位数问题。ODBC驱动是本地代码，必须跟使用它的程序位数一致。Windows下要确认两套东西：一是操作系统位数，二是你常用的Office或BI工具位数。

这里有个十分容易踩的大坑：很多人的Windows是64位，但安装的Office是32位版本（这很常见，很多企业批量部署用的就是32位Office，兼容老插件）。如果装了64位的MySQL ODBC驱动，Excel和Access反而认不出来，因为Excel是32位进程，无法加载64位驱动的DLL。正确做法是：查询已安装的Office位数，如果是32位，就下载并安装32位的MySQL ODBC驱动，哪怕操作系统是64位。反过来，操作系统是32位时，也只能用32位驱动。

3. 官网下载全流程：一步步走通

下载入口其实不难找，难的是很多人第一次进官网容易迷路，找不到层层嵌套的菜单。下面按JDBC和ODBC两条线分别走一遍，每一步都写清楚。

3.1 打开官网并定位到驱动下载区域

浏览器打开MySQL官方网站，顶部有一个“Developer Zone”菜单，点进去。接着找“Downloads”分类下的“MySQL Community (GPL) Downloads”链接，这个页面集中了社区版所有组件的下载入口，包括MySQL Server，还有各类Connector驱动。

页面往下滚动，能看到一个名为“Connectors”的区域，里面排列着Connector/J、Connector/ODBC、Connector/Python、Connector/C++等条目。这里注意区分：点错链接也是常态，曾经有同事把Connector/Python当成了普通Python连接库下载，结果配置半天都对不上。我们要找的就是Connector/J和Connector/ODBC这两项。

3.2 下载JDBC驱动jar包：选Platform Independent

在Connectors区域点击Connector/J，进入下载选择页。页面会要求选择操作系统，此时直接选“Platform Independent”，也就是平台无关版本。因为jar包是纯Java编译产物，跨平台，不需要针对Windows或Linux单独打包。

选完Platform Independent后，页面下方会给出两个压缩包：ZIP Archive和TAR.GP Archive。Windows环境一般选ZIP Archive，Linux环境选TAR.GP Archive（其实就是tar.gz压缩）。文件名形如mysql-connector-j-8.0.33.zip，点击右侧的Download按钮。

此时官网很可能会跳出一个黄色背景的登录注册界面。很多人在这里卡住，以为必须注册才能下载。其实完全不需要，页面左下角或者按钮下方有一行不太显眼的小字：“No thanks, just start my download”，点它就能直接下载，不需要填任何表单。

下载完成后，解压这个压缩包，里面核心文件就是mysql-connector-j-8.0.33.jar，可能还带一个protobuf-java等依赖jar包，那些咱们一般用不上，核心驱动文件就够。另外里面通常还有源码包和文档，不用细看。

3.3 下载ODBC驱动：看清MSI和位数

从Connectors区域点击Connector/ODBC，进入ODBC驱动的下载选择页。页面会列出测试版本和正式发布版本，强烈建议选正式发布版本，不要选Development Release，稳定性优先。

接下来选择操作系统，这里不再是简单的Platform Independent，因为ODBC驱动需要匹配系统。Windows系统会看到多个文件，主要包括MSI Installer和ZIP Archive两种格式，还有x86和x64的区分。MSI Installer是安装向导，双击即可安装，适合大多数普通用户；ZIP Archive是免安装版，解压后需要手动注册DLL，适合部署脚本批量处理。

我的建议是：日常办公和开发，直接下MSI安装包。位数按前面第2.3节确认的结果来。控制面板能查Office版本位数，这里不再重复。下载后双击MSI安装，安装过程中有一步“Setup Type”可以选择，默认Complete就行，装完系统就能识别到这个ODBC驱动。

3.4 下载完成后做一次文件核对

驱动下载完，建议顺手做两件事，不费什么时间但能避免大麻烦。

第一，确认文件大小。MySQL各驱动文件大小跟版本和格式有关，一般都在几MB到几十MB的范围，如果下下来只有几KB，极大概率是网络代理或者下载中断导致的损坏文件，直接重新下载。

第二，核对官方校验值。官网每个下载文件旁边会提供SHA256或MD5校验码。Windows下可以在命令行执行certutil -hashfile 下载的文件名 SHA256，把输出的散列值和页面上对应的一串字符对比，一模一样才说明文件完整。这个步骤尤其适合从非官网镜像或其他渠道拿到安装包的情况，验证过后心里才踏实。

4. 下载之后的正确引入方式与连接验证

驱动下载完只完成了一半，剩下的一半是“让项目真正用上驱动”。Java和ODBC两条路线的配置方式完全不同，分别展开说。

4.1 jar包引入Java项目：三种方式按情况挑

方式一，IDE手动引入。在IDEA中，把jar包复制到项目里可以自己新建一个lib目录，然后右键jar包选择“Add as Library”，或者在“Project Structure -> Modules -> Dependencies”里点加号添加JARs或目录。这种方式适合临时测试项目，小项目够用，但大项目不推荐，因为依赖管理太弱，换版本要手动删旧加新。

方式二，Maven依赖管理，这是目前新项目的主流做法。在pom.xml里添加：

<dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency>

加完后记得刷新Maven，让IDEA重新解析依赖。这里有个容易忽略的细节：老版本的Maven坐标artifactId曾经是mysql-connector-java，新版本改成了mysql-connector-j。如果你在网上复制了老坐标，本地的仓库可能有缓存，但实际拉下来的旧包特性和新包不同，连接MySQL 8.0照样可能出认证问题。

方式三，Gradle依赖管理，写法类似：

implementation 'com.mysql:mysql-connector-j:8.0.33'

无论哪种方式，引入后都可以在项目里写一段最小连接代码来确认驱动真正生效，代码见第4.3节。

4.2 Windows环境配置ODBC数据源

ODBC驱动装完后，要进入系统的ODBC数据源管理器里创建一个“数据源”，后续Excel、BI工具才能直接按名字连接数据库。

打开方式：Windows控制面板 -> 系统和安全 -> 管理工具 -> ODBC数据源(64位)。如果你装的是32位驱动，则需要运行C:\Windows\SysWOW64\odbcad32.exe这个程序，因为控制面板里默认可能只显示64位入口。Windows的目录设计有点反直觉：System32文件夹里放的是64位工具，SysWOW64文件夹反而放的是32位工具，不要搞反。

在ODBC数据源管理器里，选“系统DSN”或“用户DSN”选项卡，点击“添加”，在驱动列表中找到“MySQL ODBC 8.0 Unicode Driver”，然后填写连接参数：

• Data Source Name：给这个数据源起个名字，比如LocalMySQL
• TCP/IP Server：填localhost或具体IP
• Port：3306
• User：数据库用户名
• Password：对应密码
• Database：要连接的数据库名

填完点击“Test”按钮测试连通性，显示Connection successful就说明配置正常，后面Excel或者BI工具就能直接使用这个名为LocalMySQL的数据源了。注意：DSN配置里的密码会以明文保存在系统注册表，测试环境无所谓，生产环境建议换成较安全的方式。

4.3 写一段最小代码验证驱动真能用

Java环境验证很简单，新建一个类，写上：

import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class TestMySQL { public static void main(String[] args) throws Exception { String url = "jdbc:mysql://localhost:3306/test?useSSL=false&serverTimezone=Asia/Shanghai"; Connection conn = DriverManager.getConnection(url, "root", "123456"); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("select 1"); if (rs.next()) { System.out.println("连接成功，结果：" + rs.getInt(1)); } conn.close(); } }

如果打印出“连接成功”，说明jar包和连接串都正常。如果报错，去第5节查表对照。

ODBC验证方式之一：在Python里使用pyodbc库连接刚配好的DSN：

import pyodbc conn = pyodbc.connect( "DRIVER={MySQL ODBC 8.0 Unicode Driver};" "SERVER=127.0.0.1;PORT=3306;DATABASE=test;" "UID=root;PWD=123456;charset=utf8mb4" ) cursor = conn.cursor() cursor.execute("select 1") print(cursor.fetchone())

如果这里能查出结果，说明ODBC驱动安装和数据源配置都没问题。还有不用DSN直接写连接串的方式，我也经常用，省去在系统里配数据源的步骤，尤其适合脚本调试。

5. 高频报错与独家避坑经验

驱动相关的问题，翻来覆去就那么几类。我把这些年踩过的坑整理成速查表，再额外补充几条常规文档里不写但很有用的经验。

5.1 常见问题速查表

5.2 三条只有踩过坑才知道的经验

第一条经验：官方网站下载速度不稳定是常态，但别因此去陌生资源站下驱动。最好的替代方案是使用官方镜像站或国内开源镜像，下载完后一定按照第3.4节的方式核对校验值。我见过有同事从不明渠道下载的jar包被塞了后门，这种隐患比连接报错严重得多。

第二条经验：升级驱动版本后，如果项目死活还用旧版，先检查本地Maven仓库。Maven的本地仓库路径一般默认在用户目录下的.m2/repository，旧版本的mysql-connector-j目录不会自动删除，改了版本号后多次刷新仍没变化，直接进repositories目录把com/mysql/mysql-connector-j整个文件夹删掉，再重新构建。这个问题在更换版本号调试老项目时出现概率极高。

第三条经验：ODBC连接串里尽量显式加上charset=utf8或charset=utf8mb4。很多人用ODBC从Excel导入MySQL数据后出现中文乱码，第一反应是Excel显示问题，其实很多时候是连接串缺了字符集参数。默认字符集推断往往不可靠，显式指定后乱码立刻消除。这条建议在Python的pyodbc场景同样有效。

再说一个心态层面的经验。遇到驱动连接问题，先别急着改代码，按照这个顺序排查：MySQL服务有没有启动，端口通不通，认证方式匹配不匹配，驱动版本和JDK系统环境对不对，最后再看SQL和连接串。按这个顺序，绝大多数问题能在五分钟内定位。驱动下载是入门的关口，这个关口走顺了，后面数据库开发的路会清净许多。