MySQL 8.0安装配置、IDEA/Navicat连接与实体类生成实战

MySQL 环境搭建这件事，说简单也简单，说折磨人也真折磨人——我见过太多人在新电脑上装 MySQL 8.0，装完之后 IDEA 连不上、Navicat 报时区错误、建表时字段类型选错导致后面改表改到崩溃。这篇就把 MySQL 的安装配置、IDEA 连接、Navicat 连接、以及从建表到自动生成实体类的整条链路，按照我平时实际操作的顺序完整捋一遍。不管你是刚接触数据库的学生，还是要给新同事配环境的带教，照着走一遍基本能把环境跑通，中间几个特别容易踩的地方我也会把原因讲清楚，省得你只知道抄配置却不知道为什么这么写。

1. 动手之前先定版本和安装方式

很多人装 MySQL 卡住，根子不在安装过程，而在动手前没想清楚两件事：装哪个版本、用哪种安装方式。这两个决定一旦选错，后面所有配置都会别扭。

1.1 MySQL 8.0 和 5.7 到底选哪个

现在官方主推的是 8.0 系列，5.7 早就进入停止维护阶段了。新项目我建议直接上 8.0，原因不复杂：默认字符集从 latin1 换成了 utf8mb4，默认排序规则是 utf8mb4_0900_ai_ci，意味着存中文、emoji 都不会再出现问号乱码，省掉一堆手动改字符集的活。另外 8.0 的窗口函数、CTE、降序索引这些特性，在写复杂查询的时候是真能救命。

但有一个现实情况要提醒：如果你在维护一个老系统，它的驱动版本还停留在 5.1.x，那么接 MySQL 8.0 会直接报Unknown system variable 'query_cache_size'之类的错。这时候要么升级驱动到 8.x，要么就老老实实装 5.7。所以选版本的判断标准其实就一条：看你的项目驱动和框架依赖，而不是看网上说哪个新。

还有一个隐藏坑是版本号里的位数。Windows 上务必下 64 位版本，现在基本没有 32 位机器了，但有些老教学视频还在演示 x86 安装包，照着装完内存用不满，性能直接打折。

1.2 Installer 安装版和解压版，区别比你想的大

官方提供两种主要形式：一个是 MySQL Installer（图形化安装向导），另一个是 ZIP Archive（解压即用的绿色版）。

我自己的习惯是笔记本上装 Installer 版图省事，但在做教学或者需要同时跑 5.7 和 8.0 的机器上，一定用解压版。因为解压版把my.ini摆在你面前，端口、数据目录、字符集全都看得见，出问题的时候你知道去哪儿改。Installer 版把这些都隐藏在向导里，一旦出问题反而不好排查。

提示：两个版本不要装在同一台机器上还共用同一个数据目录，会直接把数据文件搞坏。要么端口错开（3306 / 3307），要么干脆用不同机器或者容器。

1.3 从官方渠道取安装包并核对完整性

安装包我只从官网下，不是矫情，是因为第三方站点的包经常被塞东西或者版本号对不上。官网下载页选 Windows (x86, 64-bit), MSI Installer 或者 ZIP Archive。下载完顺手看一眼文件大小和哈希值，跟页面上标注的对一下，能排除掉下载中断导致的半截包。

这一步看着像多余，但我确实遇到过同事因为安装包损坏，装到一半卡在 "Applying security settings" 界面，反复重装了三次才发现是包的问题。校验一次两分钟，能省一下午。

2. Windows 下把 MySQL 服务跑起来

安装过程本身没什么可讲的，真正决定这套环境能不能用很久的，是那几个配置项和服务注册方式。

2.1 向导里的几个关键选择项

跑 Installer 的时候，Setup Type 建议选 Custom，自己挑组件，别选 Developer Default。因为 Default 会把 MySQL Shell、Router、Workbench、示例库全给你装上，光是启动项就一堆，对只想跑个数据库的人来说纯属负担。选 Custom，只勾 MySQL Server 和 MySQL Workbench 就够了，Workbench 后面建连接的时候还能当备用工具。

进到 Type and Networking 这一步，Config Type 选 Development Computer，它会用较小的初始内存占用；如果你这台机器就是专门做数据服务的，才考虑 Server Computer。Port 保持 3306，除非你机器上已经有一个 MySQL 在跑，那就改成 3307，同时记住这个端口后面连接时要用。

Authentication Method 这步很多人会纠结。它给两个选项：强密码加密（caching_sha2_password）和传统加密（mysql_native_password）。新手建议直接选传统加密，因为不少老驱动和老客户端不认 caching_sha2_password，连接时会报Authentication plugin 'caching_sha2_password' cannot be loaded。等你确认自己的驱动是 8.x 之后，再改回强加密也不迟。

2.2 root 密码和字符集设置的取舍

设置 root 密码这步，别图省事设成123456或者root。这台机器上的数据库如果连了外网，弱密码被扫是分分钟的事。我一般会用一个自己记得住但又足够长的组合，并且单独建一个业务账号给应用用，root 只留给本机维护。

后面的 Windows Service 环节，勾上 "Configure MySQL Server as a Windows Service"，服务名保持 MySQL80 或者你自定义一个。这样开机就自动启动，不用每次手动开。

真正容易被忽略的是字符集这一步。8.0 默认已经是 utf8mb4 了，但如果你装的是 5.7 或者中途改过，一定要在向导里把 Character Set 显式设成 utf8mb4，Collation 选 utf8mb4_general_ci 或者 utf8mb4_0900_ai_ci。如果向导里没给你这个选项，那就装完之后手动去my.ini里加：

[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_general_ci [client] default-character-set=utf8mb4

改完必须重启服务才生效，net stop mysql80 && net start mysql80。

2.3 用 ZIP 版手动注册服务的完整流程

如果你走的是解压版，流程是这样的。先把 ZIP 解压到一个没有中文、没有空格的路径，比如D:\mysql-8.0.36。中文路径在某些场景下会导致初始化失败，这个坑很多人都踩过。

然后在根目录下新建my.ini：

[mysqld] basedir=D:/mysql-8.0.36 datadir=D:/mysql-8.0.36/data port=3306 character-set-server=utf8mb4 default-storage-engine=INNODB [client] port=3306 default-character-set=utf8mb4

注意路径用的是正斜杠，Windows 下反斜杠在 ini 文件里会被当成转义符，容易出问题。接着以管理员身份开命令行，执行初始化：

mysqld --initialize --console

这条命令会在控制台输出一个临时 root 密码，立刻复制下来，只显示这一次。如果你想要空密码方便本地调试，可以用mysqld --initialize-insecure，但仅限本机开发环境。

最后注册服务并启动：

mysqld --install mysql80 net start mysql80

到这一步，数据库就起来了。用mysql -uroot -p登录进去，第一件事就是ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';。

3. 登录之后立刻要做的三件收尾工作

很多人装完能连上就觉得结束了，其实这时候数据库还没真正"可用"。下面这几件事不做，后面连接 IDEA 和 Navicat 的时候一定出问题。

3.1 确认字符集和排序规则真的生效了

登录后先敲：

SHOW VARIABLES LIKE 'character%'; SHOW VARIABLES LIKE 'collation%';

看character_set_server和character_set_database是不是 utf8mb4。如果还是 latin1，说明你的my.ini没被读到——要么路径不对，要么服务没重启。这是排查字符集问题的第一站。

排序规则那边，utf8mb4_general_ci和utf8mb4_0900_ai_ci的区别值得知道：后者是 8.0 新增的，对 Unicode 的处理更规范，大小写和重音的比较规则更贴近标准。新库我一般用 0900_ai_ci，老项目兼容就沿用 general_ci，但一个库里混用两种排序规则，在做 JOIN 的时候会报 "Illegal mix of collations"。所以建库时定好，后面所有表都跟着走。

3.2 建一个应用专用账号而不是一直用 root

这件事我在团队里强调过很多次。应用连数据库用 root，等于把整个数据库的生杀大权都交出去了，一旦配置文件泄露，后果很严重。正确做法是新建账号并只授予必要的权限：

CREATE USER 'app_user'@'%' IDENTIFIED BY '一个强密码'; GRANT SELECT, INSERT, UPDATE, DELETE ON mydb.* TO 'app_user'@'%'; FLUSH PRIVILEGES;

注意'app_user'@'%'里的%表示允许任意主机连接。本地开发图方便可以这么写，但如果数据库对外提供服务，最好限定成具体 IP 段或者localhost。

如果连不上，先检查user表里的 host 字段匹配情况：

SELECT user, host FROM mysql.user;

你的连接来源是localhost走本地 socket，是127.0.0.1走 TCP，两者在权限表里是不同的记录。这个小细节绊倒过不少人，明明建了账号却提示 "Access denied"。

3.3 忘记密码时的重置思路

这个不属于正常流程，但属于必备技能。思路是让服务跳过权限检查启动，改完密码再恢复正常启动。

net stop mysql80 mysqld --skip-grant-tables --console

另开一个命令行窗口登录（这时候任何密码都能进），然后：

FLUSH PRIVILEGES; ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

改完关掉这个临时进程，正常启动服务。注意--skip-grant-tables状态下不能直接执行 ALTER USER，必须先 FLUSH PRIVILEGES 刷新权限表，否则会报错。这个顺序我是踩过一次才记住的。

4. IDEA 里连接数据库并反向生成实体类

IDEA 自带的 Database 工具是我最常用的功能之一，它比第三方客户端更贴近代码，尤其是自动生成实体类这一点，能省掉大量手写 POJO 的时间。

4.1 Database 窗口里配置连接

打开 View → Tool Windows → Database，点左上角加号，选 Data Source → MySQL。填 Host、Port、User、Password、Database。第一次点 Test Connection，大概率会失败，报错通常是这两类：

1. Public Key Retrieval is not allowed
2. The server time zone value 'XXX' is unrecognized

第一种是因为 8.0 用 caching_sha2_password 认证，客户端需要拿到公钥。解决办法是在 URL 后面加参数：

jdbc:mysql://localhost:3306/mydb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai

第二种是时区问题，serverTimezone必须显式指定，否则 MySQL 8.0 的新驱动不知道该按哪个时区解析时间。

注意：useSSL=false只在本地开发环境用，生产环境应该配好证书走加密连接，关掉 SSL 只是图个连接稳定，别把这个配置带上线。

4.2 驱动版本不匹配是最高频的报错源

IDEA 里换驱动很方便，但还是建议先看清你项目里实际用的驱动 jar 是哪个版本。com.mysql.jdbc.Driver是 5.x 的老驱动，com.mysql.cj.jdbc.Driver是 8.x 的新驱动。如果项目里 pom 引的是 8.0.33，而 IDEA 的 Data Source 用了自带的 5.1 驱动，就会出现"在 IDEA 里能连上，跑代码却连不上"的诡异现象。

解决方式是点 Data Source 里的 Driver 设置，手动指定到项目依赖的驱动版本，或者干脆用 Maven 仓库里的那个 jar。保持 IDEA 和代码用同一个驱动，能避开一大半玄学报错。

4.3 从表结构直接生成实体类

连接成功后展开数据库，选中表，右键 → Generate → 找到 Scripted Extensions 或者走 Persistence 这条路：先在项目里打开 Persistence 窗口（View → Tool Windows → Persistence），右键项目 → Generate Persistence Mapping → By Database Schema。

在弹出的配置界面里，选择数据源、要生成的包名、实体类命名规则，还可以勾选是否生成 Lombok 注解、是否生成 JPA 注解。生成的实体类字段名和表字段会自动做驼峰映射，比如user_name变成userName。

这里有个细节：IDEA 默认把 tinyint(1) 映射成 Boolean，如果你表里用 tinyint 存状态值（0/1/2 这种），生成的类型会不准确。这时候要么在建表时避开 tinyint(1) 写法（用 tinyint 不带括号长度），要么生成后手动改成 Integer。这个坑我在实际项目里踩过，状态值 2 被转成 true 之后再转回 int 就变成 1 了，排查了半天。

5. Navicat 连接与图形化建表的实操细节

Navicat 的优势在于界面直白、导入导出方便，尤其适合做数据核对和临时的表结构维护。连接本身不难，难的是建表时那些字段类型和约束怎么选。

5.1 新建连接和端口映射的处理

打开 Navicat，Connection → MySQL，填连接名、Host、Port、用户名密码。Test Connection 通过后保存即可。

如果数据库跑在虚拟机或者远程服务器上，常见的问题是防火墙没放行 3306，或者 MySQL 只监听了127.0.0.1。检查my.ini里有没有bind-address = 0.0.0.0，没有的话远程连不上。改完记得重启服务，并确认云服务器的安全组也放行了对应端口。

Navicat 里如果同一个库有多个连接，建议把连接名写清楚，比如本地-3306-开发库，否则连接列表一多，误操作到生产库是很危险的。我认识的人里就有因为在 Navicat 里连错库，把一个线上表给清空的。所以我在生产连接上都加了明显的前缀，并且关闭了自动提交。

5.2 图形化建表时字段类型怎么选

在 Navicat 里右键库 → New Table，会进入表格设计界面。这里每一项都值得说清楚：

• 主键 id：类型bigint，勾选 Auto Increment，Not Null。用 bigint 而不是 int，是因为 int 上限约 21 亿，业务量大的时候很容易撞天花板，改主键类型代价极高。
• 字符串字段：varchar带明确长度，比如用户名varchar(64)，手机号varchar(20)。不要所有字段都写 255，那样索引会变胖，查询变慢。
• 金额字段：一定用decimal(10,2)，绝对不要用 float 或 double。浮点数存 0.1 + 0.2 不等于 0.3 这件事在金额上是灾难性的。
• 时间字段：datetime和timestamp的区别要搞清。timestamp 会随时区变化，范围只到 2038 年；datetime 存的是字面值，不受时区影响，范围到 9999 年。业务时间我一般用 datetime。
• 状态字段：用tinyint不带长度，配合注释写清楚每个值的含义。

一个建表的示例 SQL 大概长这样：

CREATE TABLE `t_user` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键', `user_name` varchar(64) NOT NULL COMMENT '用户名', `phone` varchar(20) DEFAULT NULL COMMENT '手机号', `balance` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '账户余额', `status` tinyint NOT NULL DEFAULT '1' COMMENT '状态 1正常 0禁用', `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_user_name` (`user_name`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

5.3 建表过程中最常见的几类异常

建表报错几乎都集中在这几个错误码上，认脸熟之后排查会快很多。

1071 这个特别典型。用 utf8mb4 时，一个字符最多占 4 字节，InnoDB 单列索引最大 3072 字节，也就是 varchar 大概 768 字符以内可以完整建索引。你如果给varchar(1000)直接建唯一索引，就会报 1071。解决办法是建前缀索引：

ALTER TABLE t_user ADD UNIQUE KEY uk_name (user_name(191));

191 这个数字是老版本留下的经验值，因为早期 utf8mb4 索引上限是 767 字节，767 / 4 ≈ 191。现在 8.0 放宽了，但 191 仍然是个安全选择。

6. 把环境真正用起来之后的几点经验

环境跑通只是起点，能不能用得顺手，取决于你有没有把一些习惯提前建立起来。

6.1 跨平台迁移时的表名大小写问题

Windows 上的 MySQL 默认lower_case_table_names=1，表名不区分大小写；Linux 上默认是 0，区分大小写。这意味着你在 Windows 上写的T_User，迁到 Linux 上可能就找不到了。统一用小写加下划线命名表名，能直接避开这个问题，也符合大多数团队的规范。

改这个参数必须在初始化之前设置，初始化之后再改会导致数据目录启动失败，这是硬性限制，别在中途去动它。

6.2 连接串里的参数别一股脑复制

网上流传的连接串经常堆了七八个参数，什么useUnicode=true&characterEncoding=utf8&autoReconnect=true。里面有些在 8.0 里已经没必要了，比如 useUnicode，8.0 默认就是 Unicode。参数越多，出问题时越难定位是哪一个导致的。我的做法是只保留真正需要的：serverTimezone、allowPublicKeyRetrieval、必要的useSSL，其余按需再加。

6.3 本地开发库的备份节奏

本地库崩了重建其实很快，但如果里面有你自己造的一批测试数据，重造就很烦。所以我在建完表、导入初始数据之后，会用 Navicat 的 Dump SQL File 功能把结构和数据导出一份，放在项目目录的db/文件夹里。这样换电脑或者误删库时，一条命令就能恢复：

mysql -uroot -p mydb < db/mydb_init.sql

这个习惯看起来不起眼，但在我换过几次开发机之后，它救了我至少两次。

走到这儿，从 MySQL 安装、服务注册、账号权限，到 IDEA 连库生成实体类、Navicat 建表、常见异常处理，整条链路应该都能独立走通了。真正让环境稳定的从来不是某个神奇配置，而是把字符集、驱动版本、字段类型这几处基础打牢，后面遇到再奇怪的报错，排查方向也就那么几条。