373 lines
8.4 KiB
Markdown
373 lines
8.4 KiB
Markdown
# Docker环境数据库初始化指南
|
||
|
||
## 📋 概述
|
||
|
||
本指南说明如何为Docker环境准备数据库初始化脚本，参考 `schoolNewsServ/.bin/mysql/sql/reInit.sh` 的实现。
|
||
|
||
## 🎯 初始化流程
|
||
|
||
### MySQL容器启动流程
|
||
|
||
```
|
||
Docker容器启动
|
||
↓
|
||
执行 /docker-entrypoint-initdb.d/ 中的脚本（按字母顺序）
|
||
↓
|
||
01-init-database.sql → 创建数据库和初始化标记表
|
||
↓
|
||
02-create-tables.sql → 创建所有业务表
|
||
↓
|
||
03-init-data.sql → 导入初始数据
|
||
↓
|
||
数据库就绪
|
||
```
|
||
|
||
## 📂 文件说明
|
||
|
||
### 现有文件
|
||
|
||
| 文件 | 说明 | 状态 |
|
||
|------|------|------|
|
||
| `01-init-database.sql` | 创建数据库和_db_init_status表 | ✅ 已存在 |
|
||
| `README.md` | 数据库初始化说明 | ✅ 已存在 |
|
||
|
||
### 需要准备的文件
|
||
|
||
| 文件 | 说明 | 来源 |
|
||
|------|------|------|
|
||
| `02-create-tables.sql` | 所有表结构 | 从 createTable*.sql 合并 |
|
||
| `03-init-data.sql` | 初始数据 | 从 init*.sql 合并 |
|
||
|
||
## 🔧 准备方法
|
||
|
||
### 方式1: 使用自动脚本（推荐）
|
||
|
||
```bash
|
||
cd docker/init-db
|
||
chmod +x prepare-sql.sh
|
||
./prepare-sql.sh
|
||
```
|
||
|
||
脚本会自动：
|
||
1. 备份现有SQL文件
|
||
2. 合并所有createTable*.sql到02-create-tables.sql
|
||
3. 合并所有init*.sql到03-init-data.sql
|
||
4. 添加Docker特定配置（爬虫路径等）
|
||
5. 生成统计信息
|
||
|
||
### 方式2: 手动复制
|
||
|
||
#### 步骤1: 准备表结构
|
||
|
||
```bash
|
||
cd schoolNewsServ/.bin/mysql/sql
|
||
|
||
# 合并所有createTable*.sql
|
||
cat createTableUser.sql \
|
||
createTablePermission.sql \
|
||
createTablePermissionControl.sql \
|
||
createTableResource.sql \
|
||
createTableCourse.sql \
|
||
createTableLearning.sql \
|
||
createTableUserCenter.sql \
|
||
createTableAI.sql \
|
||
createTableSystem.sql \
|
||
createTableAchievement.sql \
|
||
createTableCrontab.sql \
|
||
createTableMessage.sql \
|
||
createTableSensitive.sql \
|
||
> ../../docker/init-db/02-create-tables.sql
|
||
```
|
||
|
||
#### 步骤2: 准备初始数据
|
||
|
||
```bash
|
||
# 合并所有init*.sql
|
||
cat initMenuData.sql \
|
||
initAllData.sql \
|
||
initCrontabMetaData.sql \
|
||
> ../../docker/init-db/03-init-data.sql
|
||
```
|
||
|
||
#### 步骤3: 添加Docker配置
|
||
|
||
在 `03-init-data.sql` 末尾添加：
|
||
|
||
```sql
|
||
-- Docker环境爬虫配置
|
||
INSERT IGNORE INTO tb_sys_config (config_key, config_value, config_desc, created_at)
|
||
VALUES
|
||
('crawler.pythonPath', '/usr/bin/python3', 'Docker容器内Python路径', NOW()),
|
||
('crawler.basePath', '/app/crawler', 'Docker容器内爬虫脚本路径', NOW());
|
||
```
|
||
|
||
## 🔍 脚本内容说明
|
||
|
||
### initAll.sql 结构
|
||
|
||
基于 `schoolNewsServ/.bin/mysql/sql/initAll.sql`:
|
||
|
||
```sql
|
||
-- 1. 创建数据库
|
||
SOURCE createDB.sql;
|
||
|
||
-- 2-14. 创建各模块表
|
||
SOURCE createTableUser.sql;
|
||
SOURCE createTablePermission.sql;
|
||
SOURCE createTablePermissionControl.sql;
|
||
SOURCE createTableResource.sql;
|
||
SOURCE createTableCourse.sql;
|
||
SOURCE createTableLearning.sql;
|
||
SOURCE createTableUserCenter.sql;
|
||
SOURCE createTableAI.sql;
|
||
SOURCE createTableSystem.sql;
|
||
SOURCE createTableAchievement.sql;
|
||
SOURCE createTableCrontab.sql;
|
||
SOURCE createTableMessage.sql;
|
||
SOURCE createTableSensitive.sql;
|
||
|
||
-- 15-17. 插入初始数据
|
||
SOURCE initMenuData.sql;
|
||
SOURCE initAllData.sql;
|
||
SOURCE initCrontabMetaData.sql;
|
||
```
|
||
|
||
### 各模块说明
|
||
|
||
| 模块 | 表数量 | 说明 |
|
||
|------|--------|------|
|
||
| User | 3+ | 用户、部门、角色 |
|
||
| Permission | 10+ | 菜单、权限、角色权限 |
|
||
| Resource | 5+ | 资源、标签、分类 |
|
||
| Course | 3+ | 课程、章节、课件 |
|
||
| Learning | 5+ | 学习记录、笔记 |
|
||
| UserCenter | 3+ | 个人中心、收藏、评论 |
|
||
| AI | 5+ | AI智能体、对话 |
|
||
| System | 5+ | 系统配置、日志 |
|
||
| Achievement | 5+ | 成就系统 |
|
||
| Crontab | 3+ | 定时任务 |
|
||
| Message | 3+ | 消息通知 |
|
||
| Sensitive | 1+ | 敏感词 |
|
||
|
||
## ⚠️ 重要注意事项
|
||
|
||
### 1. SOURCE语句不支持
|
||
|
||
Docker的mysql镜像初始化**不支持** `SOURCE` 语句：
|
||
|
||
```sql
|
||
-- ❌ 不支持
|
||
SOURCE createTableUser.sql;
|
||
|
||
-- ✅ 需要合并成一个文件
|
||
-- 将所有SQL内容直接写入
|
||
CREATE TABLE tb_user (...);
|
||
CREATE TABLE tb_role (...);
|
||
```
|
||
|
||
### 2. 幂等性设计
|
||
|
||
确保脚本可以重复执行：
|
||
|
||
```sql
|
||
-- 使用IF NOT EXISTS
|
||
CREATE TABLE IF NOT EXISTS tb_user (...);
|
||
|
||
-- 使用INSERT IGNORE
|
||
INSERT IGNORE INTO tb_sys_config VALUES (...);
|
||
|
||
-- 检查执行状态
|
||
SET @executed = (SELECT COUNT(*) FROM _db_init_status WHERE script_name = '02-create-tables.sql');
|
||
```
|
||
|
||
### 3. 执行顺序
|
||
|
||
文件按字母顺序执行，因此命名很重要：
|
||
|
||
```
|
||
01-init-database.sql (首先执行)
|
||
02-create-tables.sql (其次执行)
|
||
03-init-data.sql (最后执行)
|
||
```
|
||
|
||
### 4. 字符集配置
|
||
|
||
确保使用UTF-8MB4：
|
||
|
||
```sql
|
||
CREATE TABLE tb_xxx (
|
||
...
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
|
||
```
|
||
|
||
## 🧪 测试验证
|
||
|
||
### 1. 检查SQL文件
|
||
|
||
```bash
|
||
# 查看文件大小
|
||
ls -lh docker/init-db/*.sql
|
||
|
||
# 检查SQL语法
|
||
cd docker/init-db
|
||
mysql --help | grep "Default options"
|
||
```
|
||
|
||
### 2. 本地测试
|
||
|
||
```bash
|
||
# 在本地MySQL测试
|
||
mysql -uroot -p123456 < docker/init-db/01-init-database.sql
|
||
mysql -uroot -p123456 < docker/init-db/02-create-tables.sql
|
||
mysql -uroot -p123456 < docker/init-db/03-init-data.sql
|
||
```
|
||
|
||
### 3. Docker环境测试
|
||
|
||
```bash
|
||
# 删除旧数据
|
||
docker-compose down -v
|
||
|
||
# 启动MySQL
|
||
docker-compose up -d mysql
|
||
|
||
# 查看初始化日志
|
||
docker logs school-news-mysql 2>&1 | grep -E "init|sql"
|
||
|
||
# 检查数据库
|
||
docker exec school-news-mysql mysql -uroot -p123456 -e "SHOW DATABASES;"
|
||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e "SHOW TABLES;"
|
||
|
||
# 检查默认用户
|
||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||
"SELECT username, nickname FROM tb_sys_user WHERE username='admin';"
|
||
```
|
||
|
||
### 4. 验证初始化状态
|
||
|
||
```bash
|
||
# 查看初始化记录
|
||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||
"SELECT * FROM _db_init_status ORDER BY executed_at;"
|
||
|
||
# 统计表数量
|
||
docker exec school-news-mysql mysql -uroot -p123456 school_news -e \
|
||
"SELECT COUNT(*) AS table_count FROM information_schema.tables WHERE table_schema='school_news';"
|
||
```
|
||
|
||
## 🔄 更新数据库结构
|
||
|
||
### 场景1: 本地开发添加了新表
|
||
|
||
1. 在 `schoolNewsServ/.bin/mysql/sql/` 中创建SQL文件
|
||
2. 更新 `initAll.sql` 添加SOURCE语句
|
||
3. 重新运行 `prepare-sql.sh`
|
||
4. 重新构建Docker镜像
|
||
|
||
### 场景2: 修改现有表结构
|
||
|
||
1. 创建迁移脚本 `04-migration-xxx.sql`
|
||
2. 放入 `docker/init-db/` 目录
|
||
3. 脚本会自动执行（按字母顺序）
|
||
|
||
示例迁移脚本：
|
||
|
||
```sql
|
||
-- 04-migration-add-column.sql
|
||
USE school_news;
|
||
|
||
-- 检查是否已执行
|
||
SET @executed = (SELECT COUNT(*) FROM _db_init_status WHERE script_name = '04-migration-add-column.sql');
|
||
|
||
-- 添加新列
|
||
ALTER TABLE tb_user ADD COLUMN IF NOT EXISTS new_column VARCHAR(255);
|
||
|
||
-- 记录执行
|
||
INSERT IGNORE INTO _db_init_status (script_name) VALUES ('04-migration-add-column.sql');
|
||
```
|
||
|
||
## 📊 默认数据说明
|
||
|
||
### 默认用户
|
||
|
||
| 用户名 | 密码 | 角色 | 说明 |
|
||
|--------|------|------|------|
|
||
| admin | admin123 | 管理员 | 超级管理员账号 |
|
||
|
||
### 默认角色
|
||
|
||
| 角色 | 说明 |
|
||
|------|------|
|
||
| admin | 管理员，拥有所有权限 |
|
||
| freedom | 自由角色，基础权限 |
|
||
|
||
### 默认部门
|
||
|
||
| 部门 | 说明 |
|
||
|------|------|
|
||
| root_department | 超级部门 |
|
||
| default_department | 默认部门 |
|
||
|
||
### 系统配置
|
||
|
||
| 配置项 | 值 | 说明 |
|
||
|--------|-----|------|
|
||
| crawler.pythonPath | /usr/bin/python3 | Python路径 |
|
||
| crawler.basePath | /app/crawler | 爬虫脚本路径 |
|
||
|
||
## 🛠️ 故障排查
|
||
|
||
### 问题1: 初始化脚本未执行
|
||
|
||
**症状**: 数据库创建了但表不存在
|
||
|
||
**排查**:
|
||
```bash
|
||
# 查看MySQL日志
|
||
docker logs school-news-mysql
|
||
|
||
# 检查脚本权限
|
||
ls -l docker/init-db/*.sql
|
||
```
|
||
|
||
**解决**: 确保SQL文件有读权限
|
||
|
||
### 问题2: SQL语法错误
|
||
|
||
**症状**: 容器启动失败
|
||
|
||
**排查**:
|
||
```bash
|
||
# 查看详细错误
|
||
docker logs school-news-mysql 2>&1 | grep ERROR
|
||
```
|
||
|
||
**解决**: 检查SQL语法，在本地测试
|
||
|
||
### 问题3: 重复执行导致错误
|
||
|
||
**症状**: 主键冲突等错误
|
||
|
||
**解决**: 使用幂等设计
|
||
```sql
|
||
-- 使用INSERT IGNORE
|
||
INSERT IGNORE INTO ...
|
||
|
||
-- 使用ON DUPLICATE KEY UPDATE
|
||
INSERT INTO ... ON DUPLICATE KEY UPDATE ...
|
||
|
||
-- 检查执行状态
|
||
IF NOT EXISTS (SELECT ...)
|
||
```
|
||
|
||
## 📚 相关文档
|
||
|
||
- [数据库初始化README](README.md)
|
||
- [reInit.sh源文件](../../schoolNewsServ/.bin/mysql/sql/reInit.sh)
|
||
- [MySQL Docker文档](https://hub.docker.com/_/mysql)
|
||
|
||
---
|
||
|
||
**更新时间**: 2025-11-24
|
||
**基于**: schoolNewsServ/.bin/mysql/sql/reInit.sh
|