【Unity MySQL小白教程②】MySQL安装与游戏表结构设计

2025-07-21

前言

上一篇我们确定了架构方向。本篇动手做两件事：安装MySQL和设计游戏数据表。这两步看似基础，但表结构设计的好坏直接决定了后续CRUD的复杂度和性能上限。

一、MySQL快速安装（三选一）

1.1 Windows：MySQL Installer（推荐新手）

# 下载 MySQL Community Server 8.0 LTS
# https://dev.mysql.com/downloads/installer/

# 安装时选择 "Server only"，记住设置的 root 密码
# 默认端口 3306，字符集选 utf8mb4

验证安装：

1
2
3

mysql -u root -p
# 输入密码后看到 mysql> 提示符即成功
SHOW VERSION();

1.2 macOS：Homebrew

1
2
3

brew install mysql
brew services start mysql
mysql_secure_installation   # 设置root密码、移除测试库

1.3 Linux (Ubuntu/Debian)

sudo apt update
sudo apt install mysql-server
sudo mysql_secure_installation
sudo systemctl enable mysql
sudo systemctl start mysql

💡 统一要求：MySQL 8.0+，字符集 utf8mb4，排序规则 utf8mb4_unicode_ci。

二、创建游戏数据库

-- 创建数据库
CREATE DATABASE IF NOT EXISTS game_db
  DEFAULT CHARACTER SET utf8mb4
  DEFAULT COLLATE utf8mb4_unicode_ci;

USE game_db;

-- 创建专用账号（不要用root！）
CREATE USER 'game_app'@'%' IDENTIFIED BY 'YourStr0ng!Pass';
GRANT SELECT, INSERT, UPDATE, DELETE ON game_db.* TO 'game_app'@'%';
FLUSH PRIVILEGES;

⚠️ 生产环境中 'game_app'@'%' 应改为具体IP，如 'game_app'@'10.0.0.%'。

三、核心表结构设计

以一个玩家管理系统为例，设计4张核心表：

3.1 玩家账号表

CREATE TABLE players (
    id          BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    username    VARCHAR(32)  NOT NULL UNIQUE COMMENT '登录名',
    nickname    VARCHAR(64)  NOT NULL COMMENT '显示昵称',
    email       VARCHAR(128) DEFAULT NULL COMMENT '邮箱(可选)',
    password_hash CHAR(60)   NOT NULL COMMENT 'bcrypt哈希',
    level       INT UNSIGNED NOT NULL DEFAULT 1,
    exp         BIGINT UNSIGNED NOT NULL DEFAULT 0,
    gold        BIGINT UNSIGNED NOT NULL DEFAULT 0,
    diamond     INT UNSIGNED NOT NULL DEFAULT 0,
    avatar_id   INT UNSIGNED NOT NULL DEFAULT 1,
    status      TINYINT NOT NULL DEFAULT 1 COMMENT '1正常 2封禁 3注销',
    created_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    
    INDEX idx_username (username),
    INDEX idx_level (level),
    INDEX idx_created (created_at)
) ENGINE=InnoDB COMMENT='玩家账号表';

3.2 背包物品表

CREATE TABLE player_items (
    id          BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    player_id   BIGINT UNSIGNED NOT NULL,
    item_id     INT UNSIGNED NOT NULL COMMENT '物品配置ID',
    quantity    INT UNSIGNED NOT NULL DEFAULT 1,
    extra_data  JSON DEFAULT NULL COMMENT '附加属性(强化/附魔等)',
    obtained_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    
    FOREIGN KEY (player_id) REFERENCES players(id) ON DELETE CASCADE,
    INDEX idx_player_items (player_id, item_id),
    UNIQUE INDEX uk_player_item (player_id, item_id)
) ENGINE=InnoDB COMMENT='玩家背包表';

3.3 登录日志表

CREATE TABLE login_logs (
    id          BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    player_id   BIGINT UNSIGNED NOT NULL,
    login_ip    VARCHAR(45) NOT NULL COMMENT '支持IPv6',
    device_info VARCHAR(256) DEFAULT NULL,
    login_time  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    
    FOREIGN KEY (player_id) REFERENCES players(id) ON DELETE CASCADE,
    INDEX idx_player_time (player_id, login_time),
    INDEX idx_login_time (login_time)
) ENGINE=InnoDB COMMENT='登录日志表';

3.4 排行榜快照表

CREATE TABLE leaderboard_snapshots (
    id          BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    season_id   INT UNSIGNED NOT NULL COMMENT '赛季ID',
    rank_type   VARCHAR(32) NOT NULL COMMENT 'power/gold/level',
    player_id   BIGINT UNSIGNED NOT NULL,
    rank_pos    INT UNSIGNED NOT NULL,
    score       BIGINT UNSIGNED NOT NULL,
    snapshot_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    
    FOREIGN KEY (player_id) REFERENCES players(id) ON DELETE CASCADE,
    INDEX idx_season_rank (season_id, rank_type, rank_pos),
    UNIQUE INDEX uk_season_player_type (season_id, rank_type, player_id)
) ENGINE=InnoDB COMMENT='排行榜快照表';

四、表设计黄金法则

法则	说明	反面教材
主键用BIGINT自增	避免UUID做聚簇索引，写入性能差10倍	`id VARCHAR(36) PRIMARY KEY`
字符串给合理长度	VARCHAR(32)而非VARCHAR(255)，节省索引空间	所有字段都VARCHAR(255)
金额用UNSIGNED整数	金币存分(cents)，避免浮点精度问题	`gold DECIMAL(10,2)`
时间用DATETIME	自动维护updated_at，方便排查问题	用INT存时间戳
外键+级联删除	保证数据一致性	手动DELETE多张表
索引按需创建	每个WHERE/JOIN字段考虑加索引	给每个字段都加索引
JSON存灵活扩展	extra_data存非结构化属性	新建几十列nullable字段

五、插入测试数据

-- 插入测试玩家
INSERT INTO players (username, nickname, password_hash, level, gold) VALUES
('test001', '剑圣无双', '$2b$12$LJ3m4ys...', 25, 158000),
('test002', '魔法少女', '$2b$12$kR9x2ab...', 18, 72000),
('test003', '暗影刺客', '$2b$12$Pq7wEfg...', 32, 230000);

-- 插入背包物品
INSERT INTO player_items (player_id, item_id, quantity) VALUES
(1, 1001, 5),   -- test001 拥有5个生命药水
(1, 2003, 1),   -- test001 拥有1把传说剑
(2, 1001, 12),  -- test002 拥有12个生命药水
(3, 3001, 3);   -- test003 拥有3个技能书

-- 验证
SELECT p.nickname, i.item_id, i.quantity
FROM players p
JOIN player_items i ON p.id = i.player_id
ORDER BY p.id, i.item_id;

六、常用管理命令速查

-- 查看表结构
DESCRIBE players;
SHOW CREATE TABLE players;

-- 查看索引
SHOW INDEX FROM players;

-- 查看表大小
SELECT table_name, 
       ROUND(data_length/1024/1024, 2) AS data_mb,
       ROUND(index_length/1024/1024, 2) AS index_mb,
       table_rows
FROM information_schema.tables
WHERE table_schema = 'game_db';

-- 慢查询日志（开发期开启）
SET GLOBAL slow_query_log = ON;
SET GLOBAL long_query_time = 1;

总结

好的表结构是改出来的不是想出来的。先按本篇模板建表跑通流程，上线前再用EXPLAIN逐条分析SQL、根据实际查询模式调整索引。记住三个数字：BIGINT主键、VARCHAR合理长度、UNSIGNED存金额。

下一篇我们在Unity中配置MySQL驱动，跑通第一个查询。

系列导航
← 第1篇：架构选型与安全原则
 第3篇：Unity环境配置与驱动选型 →

前言