简介：面向 Unity 开发者的 MySQL 数据展示整合包，适用于在 Unity 2020.3.45f1 客户端直连数据库、读取表格数据，并借助 Simple TableUI 完成界面渲染的技术场景，尤其适合做后台管理面板、数据监控看板或本地工具类应用的中级开发者。资源围绕“连接—读取—显示—排错”的主线展开，既包含 MySQL 连接配置、查询语句调用、数据模型转换等基础环节，也覆盖 Simple TableUI 在使用中常见的初始化异常、字段匹配错误、数据源刷新不及时等问题，并给出针对性的排错方向，可显著减少自行摸索过程中的编译障碍。配套博文演示了整个操作链路，便于边看边对照实践。压缩包以 zip 格式打包，整体约 24.36MB，内容集中、体积适中，下载后即可按说明展开学习。目前已有 742 人浏览学习，适合需要快速把 MySQL 数据变成 Unity 内可视化表格的读者参考复用，对初学 Unity 数据可视化或想改进现有列表展示效果的人尤为实用。
1. Unity 连接 MySql 显示表格（Simple TableUI）：从数据库到界面的最后一公里
做工具、做编辑器扩展或者做轻量后台的时候，最常卡住的一个需求就是：Unity 连接 MySql 显示表格（Simple TableUI）。游戏客户端不想开浏览器，也不想切到 Navicat 里看数据，就希望游戏里点一下按钮，数据库表立刻以表格形式呈现在屏幕上。这个方案的核心是三层：MySql 连接层、数据查询层、uGUI 表格渲染层。它适合要快速交付内部工具的人，也适合刚接触数据库集成的 Unity 开发者——不需要上重型网络框架，也不用引入大而全的 UI 插件，一两个脚本就能跑通。把数据从数据库里拽出来往后端页面放不难，难的是用 Unity 的 uGUI 把字段名、行、列、滚动条组织得干净利落。下面按我实际落地时走的路线一步步拆开讲。
2. 选型与准备：驱动库、表格组件与工程结构
动手前先解决两个选型问题：用哪个 MySql 驱动库，表格 UI 怎么搭。选错后面全是坑，这两个点值得花十分钟确认。
2.1 驱动库选型：MySql.Data 的版本陷阱与备选
Unity 里连 MySql 的常见做法是引用 MySql.Data.dll，这是 Oracle 官方 .NET 驱动。但它有个明显痛点：不同 Unity 版本对 .NET 版本的支持不同，Unity 2021 以下默认走 .NET Standard 2.0 / Mono，而 MySql.Data 8.0.x 用的依赖项较多，扔进 Plugins 文件夹后经常在运行时报找不到文件或安全策略异常。
我一般先看 Unity 版本再定驱动。Unity 2020 及之前的项目，用 MySql.Data 8.0.32 左右的版本更多；Unity 2021 以上可以尝试最新版，但一旦报了System.Security.SecurityException或者FileNotFoundException: MySql.Data，我不会去逐条引用缺失程序集，而是直接换驱动方案。
第二个备选方案是 MySqlConnector，纯托管库，依赖少，对 Unity 的 Mono 环境支持更好，而且 Async 方法更完整。如果你的项目是从零开始、没有历史包袱，我建议第一选择就是它。本篇文章的示例代码用 MySql.Data 写，因为搜索这个标题的人多数已经手里有 dll 了，但末尾会给出切换成 MySqlConnector 时只有命名空间不同的说明。
2.2 表格载体：复用 uGUI ScrollView 还是引入第三方插件
表格显示层是另一个容易想复杂的地方。Simple TableUI 的思路是尽量轻，不绑任何第三方 UI 插件，直接用 uGUI 的 ScrollRect 组装表格。
具体做法是：一个 ScrollRect 组件作为可视区，Content 节点挂 VerticalLayoutGroup，每一行是一个带背景图的 HorizontalLayoutGroup，行里的每个格子是一个 Text 或 TMP_Text。这套结构的好处是零插件依赖、任意分辨率下 Content 可以自动撑开、ScrollRect 的滚动条天然可用。
如果你项目里已经引入了带表格功能的 UI 插件，当然可以直接用。但做工具类界面时我倾向于少引依赖，因为工具界面往往要放进正式游戏工程，第三方插件的版本冲突、字体、Shader 兼容问题都会变成后续维护成本。
2.3 最小工程结构与文件清单
建议按下面的目录结构组织代码，后面维护时不会到处找脚本：
Assets/ Plugins/ MySql.Data.dll MySql.Data.xml Scripts/ DB/ DBConfig.cs DBManager.cs DBQueryExecutor.cs UI/ SimpleTableUI.cs SimpleTableRow.cs SimpleTableCell.cs Prefabs/ UIRoot.prefab TableRow.prefabDBConfig 管连接字符串，DBManager 管打开/关闭连接和查询，DBQueryExecutor 管查询逻辑与异步回调，SimpleTableUI 负责把 DataTable 渲染成 UI 行。按这个分层，之后想换成数据表展示、字段过滤、分页逻辑，都只动 UI 层就够了。
Plugins 文件夹里放 dll 时有一点要注意：Unity 默认对 Plugins 下的程序集有任何兼容性也会全量打进去，发布 Player 时要确认在 Player Settings 的 Active Input Handling 和 Api Compatibility Level 里，选的 .NET 版本不是过旧的 2.0。.NET 版本我一般结合 MySql 驱动的目标框架设成 .NET Standard 2.0，能兼容更多环境。
3. 从查询到渲染：Simple TableUI 的完整实现与参数说明
这章是核心，先实现数据库连接，再写查询，最后把结果渲染成表格。
3.1 连接字符串配置与最小连接类
连接字符串直接写死在脚本里不是最好的做法，但工具类项目最怕过度设计。我一般放到一个 DBConfig 静态类里，这样只改一处。
// DBConfig.cs using System; public static class DBConfig { public static string Server = "127.0.0.1"; public static int Port = 3306; public static string User = "root"; public static string Password = "your_password"; public static string Database = "game_db"; public static string Charset = "utf8mb4"; public static bool Pooling = true; public static uint ConnectionTimeout = 10; public static string GetConnectionString() { return string.Format( "Server={0};Port={1};User={2};Password={3};Database={4};" + "Charset={5};Pooling={6};ConnectionTimeout={7};SslMode=None;", Server, Port, User, Password, Database, Charset, Pooling, ConnectionTimeout); } }关键参数说明：Charset=utf8mb4是中文正常显示的前提，用utf8会在部分字符集环境下出现显示问题；SslMode=None是测试内网环境的常见配置，MySQL 8 默认要求 SSL 校验，本地工具开着自签证书反而容易连不上；Pooling=true避免反复握手，工具界面频繁点按钮刷新时收益明显。
3.2 查询数据并转成可渲染的 DataTable
连接写完后写一个查询执行器，返回DataTable。这一步要顺手做两件事：用参数化 SQL 避免拼字符串注入；查询结束及时释放连接。
// DBQueryExecutor.cs using UnityEngine; using MySql.Data.MySqlClient; using System.Data; public class DBQueryExecutor { public DataTable ExecuteQuery(string sql) { DataTable dt = new DataTable(); using (MySqlConnection conn = new MySqlConnection(DBConfig.GetConnectionString())) { conn.Open(); using (MySqlCommand cmd = new MySqlCommand(sql, conn)) { cmd.CommandType = CommandType.Text; using (MySqlDataAdapter adapter = new MySqlDataAdapter(cmd)) { adapter.Fill(dt); } } } return dt; } public DataTable ExecuteQueryWithParams(string sql, params MySqlParameter[] parameters) { DataTable dt = new DataTable(); using (MySqlConnection conn = new MySqlConnection(DBConfig.GetConnectionString())) { conn.Open(); using (MySqlCommand cmd = new MySqlCommand(sql, conn)) { cmd.Parameters.AddRange(parameters); using (MySqlDataAdapter adapter = new MySqlDataAdapter(cmd)) { adapter.Fill(dt); } } } return dt; } }这段代码的逻辑不复杂，注意using块的使用：MySqlConnection、MySqlCommand、MySqlDataAdapter 都实现了 IDisposable，逐层 using 能保证连接即使异常也会释放。很多人的工具跑两天就报连接池耗尽，就是漏了 finally 块或没写 using。参数化查询的方法里，MySqlParameter可以用cmd.Parameters.AddWithValue("key", value)简写，但 AddWithValue 在 MySQL 8 的某些版本下推断类型不准确，显式new MySqlParameter("key", MySqlDbType.Int32)更稳。
3.3 UI 动态生成：行列布局与自适应列宽
拿到 DataTable 之后，进入 SimpleTableUI 的渲染逻辑。每次刷新都要重建行，行数 = DataTable.Rows.Count，列数 = DataTable.Columns.Count。这一层用代码动态生成，而不是在编辑器里手拖几十个 Text，是因为列是动态的，字段一变就全废了。
// SimpleTableUI.cs using UnityEngine; using UnityEngine.UI; using System.Data; public class SimpleTableUI : MonoBehaviour { public GameObject headerPrefab; // 表头行模板 public GameObject rowPrefab; // 数据行模板 public Transform contentRoot; // ScrollRect 的 Content private DBQueryExecutor executor = new DBQueryExecutor(); public void LoadData(string tableName) { DataTable dt = executor.ExecuteQuery("SELECT * FROM " + tableName + " LIMIT 500;"); RenderTable(dt); } private void RenderTable(DataTable dt) { foreach (Transform child in contentRoot) { Destroy(child.gameObject); } // 表头行 GameObject header = Instantiate(headerPrefab, contentRoot); SetRowTexts(header, dt.Columns); // 数据行 for (int i = 0; i < dt.Rows.Count; i++) { GameObject row = Instantiate(rowPrefab, contentRoot); SetRowTexts(row, dt.Rows[i], dt.Columns); } } private void SetRowTexts(GameObject row, DataColumnCollection cols) { // 行内格子的 Text 数组按顺序排列 Text[] texts = row.GetComponentsInChildren<Text>(); for (int i = 0; i < texts.Length; i++) { if (i < cols.Count) texts[i].text = cols[i].ColumnName; } } private void SetRowTexts(GameObject row, DataRow dataRow, DataColumnCollection cols) { Text[] texts = row.GetComponentsInChildren<Text>(); for (int i = 0; i < texts.Length; i++) { if (i < cols.Count) texts[i].text = dataRow[i].ToString(); } } }逻辑说明写到这，几个关键点：Destroy是延迟删除，连续刷新两次表格会出现闪一下；要瞬间清掉旧数据，用DestroyImmediate配合contentRoot.DetachChildren()或者直接游戏对象池。表头和数据行共用同一个模板会造成表头格式和数据行没区别，建议单独做一个表头模板，多一个背景色半透明遮罩。
参数层面，LIMIT 500是防手滑。工具界面的刚需是能看到数据，不是一次拉几十万行。等表格能跑通，再看要不要加分页，别上来就全量查询。
3.4 行模板的必需品：LayoutElement 与 Text 对齐
行模板在 Hierarchy 里长这样：Row(Prefab) 下挂 HorizontalLayoutGroup，里面每个 Cell 是一个带 LayoutElement 的 Image + Text。HorizontalLayoutGroup 的四个值影响所有格子，我常用的是Spacing = 8，Padding = 4,4,4,4，ChildForceExpandWidth = false。
Cell 上的 LayoutElement 是列宽控制的入口。PreferredWidth指定理想宽度，FlexibleWidth设为 1 表示自动占满剩余空间。列多的时候，我会把第一列设置MinWidth = 80，其余列按类型给 60~200 不等。这样数据库字段再多，UI 也不会挤成一团。
4. 连接参数与数据权限：编码、连接池、执行权限的细节
表格显示出来之后，接下来最重要的问题不是界面好看，而是这个工具在真实使用环境下不会翻车。最常翻车的是中文乱码、连接池占满、查询超时。
4.1 表结构字段与 DataTable 映射的边界
ExecuteQuery拿到的 DataTable 列名直接来自数据库字段名，如果你的字段名里带下划线，表格表头就会原样显示 product_id 而不是产品 ID。工具给策划或运营用，他们会抱怨看不懂列名。常见的解决办法是在 SQL 层做别名映射：SELECT product_id AS '产品ID', product_name AS '商品名' FROM product，或者传给 UI 一个列名映射字典。
另一个坑是字段类型。DataTable 取出的是强类型值，比如 DATETIME 取出来是 DateTime，但你 ToString() 后的格式是2025-06-01 12:00:00，想显示简短版本就得在 SQL 层用DATE_FORMAT(create_time, '%Y-%m-%d %H:%i')格式化。
4.2 MySQL 的等待超时与连接池耗尽
连接池耗尽是这个方案最常见的黑匣子问题，表现是：工具开了半小时，点一下刷新，卡了 10 秒后报Timeout expired。
原因通常有两个。第一是连接没释放，打开连接后没关，连接池满了，新连接只能等；第二是 MySQL 服务端的wait_timeout把空闲连接回收了，客户端连接池还不知道，拿着死连接去用。
排查方法分三步，先用SHOW STATUS LIKE 'Threads_connected';看当前连接数，再在代码里确认每个连接都在 using 块里，最后在连接字符串里设置Connection Lifetime参数，让连接池定期清掉闲置连接。连接池的 Connection 不是越多越好，默认池大小 100 足够工具场景，关键是不能泄漏。
4.3 账号权限最小化与敏感数据脱敏
工具连数据库要用专门的只读账号，不要直接用 root。SQL 注入在这个场景里基本是自伤，但权限给小了能避免手滑删表。做法是在 MySQL 里创建一个只读用户：
CREATE USER 'tool_reader'@'%' IDENTIFIED BY 'Tool_Read@123'; GRANT SELECT ON game_db.* TO 'tool_reader'@'%'; FLUSH PRIVILEGES;工具账号只给 SELECT，DELETE/UPDATE/DROP 一律不给。这个习惯救过我两次——有次在测试环境把 UPDATE 写成了 DELETE，因为账号只读，报错后数据没丢。
另一个容易被忽略的是密码管理。Unity 客户端是剥离工具，但如果你拿到的是别人打包好的工具，连接串其实可以通过反编译拿到。敏感数据处理原则：工具内展示的身份证号、手机号要在 SQL 层直接脱敏，比如SELECT CONCAT(LEFT(phone,3), '****', RIGHT(phone,4))，别把全量敏感数据拉到本地再隐藏，还没显示到 UI 上就已经在内存里过了一遍。
5. 避坑：Unity 连 MySQL 最常见的 5 个翻车现场
5.1 连不上：Host 'xxx' is not allowed to connect to this MySQL server
现象：运行时报错Host '192.168.1.10' is not allowed to connect to this MySQL server。
原因：MySQL 默认只允许 localhost 连接，远程连接权限没开。
解决：在 MySQL 服务器上执行GRANT ALL PRIVILEGES ON game_db.* TO 'tool_reader'@'%';，或者创建账号时指定 IP 网段。注意%不是允许所有 IP，在 MySQL 8 里%代表所有主机，但 localhost 是单独记录的，如果工具是连 127.0.0.1 而代码里写 localhost，也会出现这个问题。
5.2 中文全部变成问号
现象：表格里所有中文显示为????????。
原因：连接字符串里少了分号或者漏了Charset=utf8mb4参数；也可能数据库表本身是 latin1 字符集。
解决：连接字符串按 3.1 节的写法补齐 Charset；再执行ALTER TABLE tablename CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;。表改完重启工具再拉数据就正常了。
5.3 每次查询都卡住主线程，点击按钮后界面假死
现象：按下查询按钮，界面卡 1~2 秒，然后才出表格。数据量大时卡 5 秒以上。
原因：查询逻辑直接跑在主线程，MySqlConnection.Open() 和 adapter.Fill() 都是 IO 阻塞操作。
解决：UI 操作放主线程，数据库查询放后台线程。开一个线程执行查询，完成后用 Unity 的UnityMainThreadDispatcher回调主线程生成 UI，具体代码在第 6 章。
5.4 发布到 Windows 后报错 FileNotFoundException: MySql.Data
现象：编辑器里跑得好好的，打包后再打开，点查询直接报找不到 MySql.Data。
原因：MySql.Data.dll 没有被打进包，或者没随构建一起拷贝。Plugins 下的 dll 有时在子目录中未被识别为需要拷贝的资源。
解决：打开 Plugins 文件夹，在 MySql.Data.dll 的 Inspector 面板里确认Any Platform勾上了，而且在Include in Build选项选中。另一个隐蔽原因是 dll 放在 Editor 文件夹或 StreamingAssets 文件夹里了，移动它到 Plugins 根目录。
5.5 SSL 连接错误：Authentication to host failed
现象：连接时报MySql.Data.MySqlClient.MySqlException: Authentication to host '...' for user '...' using method '...' failed，且错误前缀有 SSL 字样。
原因：MySQL 8 默认开启了 SSL 校验，但客户端侧驱动拿不到可信证书，或自签证书不被信任。Unity 里的 Mono 环境对自签证书的信任处理很麻烦，属于血泪经验区。
解决：测试环境连接字符串加SslMode=None;（如 3.1 节）；生产环境如果 MySQL 有正式证书，把SslMode=Preferred留空，避免强制 None 泄露密码。这行字写错，排查起SSL来是玄学级别的体验，先从 SslMode 入手改。
6. 异步加载与增量刷新：把 Simple TableUI 做成常用工具界面
表格能同步显示之后，最后的收尾工作是让它别卡界面、能刷新、能看大数据表。这里说两个我常用的进阶处理。
6.1 用线程做异步查询，主线程只做 UI 刷新
Unity 2021 上异步可以走 async/await，但这套代码在 2020 上就得改。我给一个通用写法，兼容所有版本：
// SimpleTableUI_Async.cs using System; using System.Threading; using System.Data; using UnityEngine; public class SimpleTableUI_Async : MonoBehaviour { public GameObject rowPrefab; public Transform contentRoot; public GameObject loadingPanel; public void LoadAsync(string tableName) { loadingPanel.SetActive(true); ThreadPool.QueueUserWorkItem(state => { DBQueryExecutor executor = new DBQueryExecutor(); DataTable dt = executor.ExecuteQuery("SELECT * FROM " + tableName + " LIMIT 1000;"); RunOnMainThread(() => { RenderTable(dt); loadingPanel.SetActive(false); }); }); } private void RunOnMainThread(Action action) { MainThreadQueue.Enqueue(action); } }MainThreadQueue是一个轻量分发器，Update 里把队列里的 Action 逐个执行。注意查询线程里不要碰任何 Unity API，Instantiate、Destroy、Text.text都必须在主线程。这里的RunOnMainThread只是一个示意，实际落地时可以用 UniTask 的UniTask.SwitchToMainThread或者自己维护一个 ConcurrentQueue。线程池的默认线程数足够，别在工具里起裸 Thread，也不好管。
6.2 增量刷新与分页——别让表格一屏装十万行
同步刷新掉一整个表再重建所有行，会让你点击查询按钮后等半天出不来看见凉 UI。实用做法是加两个参数：页码和页大小。
SELECT * FROM product ORDER BY id DESC LIMIT 200 OFFSET 0;每次翻页只查 200 条，渲染 200 个 Text 在 uGUI 里是合理的，超过 1000 行时请优先想着分页而不是优化渲染。刷新功能我一般做成按钮 + 快捷键（按 R 重新抓当前页），这样本地改了数据也能快速同步。若你还想要一个“点某个表格行看对应字段详情”的弹窗，复用同一个 DataRow 数据即可，这属于表格之后的交互扩展，第 3 章的DataRow里保留原始字段类型就是为这个准备的。
最后收一句个人习惯：做这类数据库工具，我会把连接字符串放在不被 Git 跟踪的DBConfig.local.cs中，提交时只留模板。团队里接手的人永远会拿着连接串问为什么连不上，把配置抽出来之后每次排错都快很多。Simple TableUI 做到能查、能分页、能异步、能脱敏这四件事，工具就能安心交到策划手里用了。希望帮到你。
本文还有配套的精品资源，点击获取
