搬书小二很多Unity开发者做到一定阶段都会遇到同一个问题：项目需要一个真正的数据库，而不是把数据塞进PlayerPrefs或者本地JSON文件。我自己是在做一个跨端小游戏项目时被逼着去搞Unity3D连接MySQL的，当时排行榜、用户存档、活动配置全都要从服务器拉，本地文件方案根本撑不住。折腾了几天，踩了各种坑之后，我把整套流程和排查思路完整整理了出来，这篇东西应该能帮你少走很多弯路。无论你是刚接触数据库的新手，还是已经用PlayerPrefs顶了很长时间的独立开发者，看完都能直接上手。照着做，大概一个下午就能在你的Unity项目里跑通MySQL的读写。
1. 为什么非要在Unity里接MySQL——适用场景与选型思考
1.1 从数据存PlayerPrefs说起
先说个真实场景。我做过一个多人小游戏，最初为了省事，所有玩家数据都存PlayerPrefs。单机测试没问题，一旦上了真机、多设备登录，问题全冒出来了：换设备存档没了、排行榜数据对不上、运营想改活动配置只能发版。这个阶段我意识到，必须在游戏端直接连一个真正的数据库。
很多人的第一反应是"Unity小项目用不上MySQL，太重了"。这个想法对了一半。纯单机、无网络、无账号体系的小游戏确实不需要，但以下情况基本绕不开：
- 排行榜、对战记录等需要跨玩家共享的数据；
- 玩家在不同设备上的存档同步；
- 运营配置（活动开关、道具价格、公告）不希望每次改都要重新发包；
- 需要对数据做统计分析，而不仅仅是"读出来显示"。
这时候MySQL是一个足够成熟、资料丰富、部署灵活的方案。和SQLite相比，MySQL天然支持多客户端并发写，SQLite在并发写场景下很容易遇到锁问题。如果你的游戏是纯本地单机，SQLite确实更轻；但只要有联网和多人需求，MySQL几乎是成本最低的选择。
1.2 直接连MySQL和走后端API怎么选
这里必须说一个经常被吐槽的误区：很多教程一上来就教你在Unity客户端里拼SQL语句直连MySQL，完全不提有没有安全风险。实际项目中你需要区分两种情况：
- 原型验证、内部工具、数据量小且不涉及敏感数据的场景——直接连，快、省事；
- 正式商业项目——通常建议客户端经过后端HTTP接口读写数据，数据库只对后端开放。
但直连MySQL仍然是每个Unity开发者应该掌握的技术，原因有三点：第一，很多原型验证阶段直连最快，能帮你快速验证玩法；第二，开发期用直连调试数据比走后端接口方便太多；第三，很多内部工具、编辑器扩展本身就是直接操作数据库的。所以学会它，不代表你一定在正式环境用它，但用到时你会有底气。
1.3 技术栈和性能预期
在动手之前，先明确一下这套方案的技术边界。Unity端使用C#，通过MySQL官方提供的Connector/NET驱动（即MySql.Data）来访问MySQL数据库。Unity 2018.3以上版本都支持.NET 4.x脚本运行时，这是使用MySQL驱动的基础。数据库端使用MySQL 8.x，这是目前的稳定主线版本。
性能方面要有一个合理的预期：Unity端直连MySQL的网络开销是毫秒级到几十毫秒级不等，取决于网络环境。如果数据库和目标玩家在同一个局域网（比如线下活动的现场排行榜），体验很流畅；如果走公网，就必须考虑异步加载和超时策略，这些问题我在后面会专门展开。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：从零装好MySQL 8.0并备好可视化工具
2.1 MySQL Server安装与基础配置
网上MySQL安装教程非常多，但很多人装完连不上，问题往往出在几个细节上。先讲标准流程，再提醒几个容易忽略的点。
第一步：下载安装包。
到MySQL官网下载MySQL Community Server。Windows用户注意选择MSI Installer版本，安装过程会引导配置。macOS用户可以用DMG安装包，也可以直接用Homebrew安装，命令是：
bash复制brew install mysql
第二步：安装过程中的关键配置。
- 端口默认3306，除非你明确知道要改，否则保持默认；
- 认证方式在安装时会让你选，这里先记住选"Use Legacy Authentication"或者后面再去改，因为MySQL 8.0默认的caching_sha2_password认证方式会让老版本的Connector/NET连不上（我后面专门讲这个坑）；
- Root密码务必记牢，后面所有操作都离不开它。
第三步：启动并验证。
Windows服务安装完成后，打开cmd或者PowerShell，执行：
bash复制mysql -u root -p
输入刚才设置的root密码，能进到mysql>提示符说明Server装好了。
提示：很多人在这一步卡住，提示"mysql不是内部或外部命令"。这是环境变量没配好。Windows系统需要把MySQL的bin目录（比如C:\Program Files\MySQL\MySQL Server 8.0\bin）加到系统PATH里。macOS/Linux通常不用额外配。
2.2 可视化工具：Workbench还是Navicat
装完Server之后，强烈建议再装一个可视化工具，否则每次都要敲命令行建表查数据，效率太低了。两套主流的方案：
- MySQL Workbench：官方免费，功能够用，安装包在装MySQL Server时就可以勾选。优点是不用额外找破解，缺点是界面略显笨重，但胜在稳。
- Navicat for MySQL：商用工具，界面更友好，导入导出、数据同步、ER图这些功能更省心。适合日常频繁操作数据库的人。
我自己是主力用Navicat，偶尔用Workbench。对于新手，我更推荐先从Workbench上手，免费且踩坑资料多。无论用哪个，核心操作都一样：连上Server，建库，建表，写SQL，然后执行。工具只是外壳，SQL基本功才是内核。
2.3 创建游戏库、专用账号和测试表
这里我强烈建议一个实践：不要用root账号去连Unity项目。root权限太大，万一客户端连接串泄露，整个数据库都暴露了。应该为项目创建一个专用账号，只给最小权限。
打开Workbench，连上Server，执行以下SQL：
sql复制-- 创建项目数据库
CREATE DATABASE IF NOT EXISTS game_db DEFAULT CHARACTER SET utf8mb4;
-- 创建专用账号，只允许从任意主机连接（按需调整）
CREATE USER 'game_user'@'%' IDENTIFIED BY 'your_strong_password';
-- 授权：只给game_db的所有权限
GRANT ALL PRIVILEGES ON game_db.* TO 'game_user'@'%';
-- 刷新权限
FLUSH PRIVILEGES;
utf8mb4这个字符集一定要用，它能完整支持emoji和生僻字。之前有人用默认的utf8，玩家昵称里带个emoji直接写入失败，查了半天才发现是字符集问题。
然后创建一张最基础的玩家表，后面测试就用它：
sql复制USE game_db;
CREATE TABLE player (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(64) NOT NULL,
level INT DEFAULT 1,
score INT DEFAULT 0,
last_login DATETIME
);
顺带说一个和热搜词"mysql中int+5"相关的小细节：MySQL的INT类型是32位整数，上限是2147483647，如果玩家分数会超过这个数，就要考虑BIGINT。存时间戳就用DATETIME或者BIGINT，各有利弊，DATETIME可读性好，BIGINT在排序和时区处理上更省心。我个人的习惯是游戏业务里统一用DATETIME，方便排查问题。
2.4 验证专用账号能否正常连接
在命令行换个账号试试，确认账号没问题：
bash复制mysql -u game_user -p game_db
能进到mysql>说明账号和权限都没问题。这一步千万别省，因为Unity连不上时，排除账号问题能节省大量时间。