SurveyKing项目数据库迁移指南：从H2到MySQL

背景介绍

SurveyKing是一款开源的问卷调查系统，其Docker版本默认使用H2嵌入式数据库。H2数据库虽然轻量便捷，但在生产环境中存在诸多限制：缺乏专业管理工具、性能瓶颈、备份恢复复杂等问题。本文将详细介绍如何将SurveyKing从H2数据库迁移到更专业的MySQL数据库。

迁移前的准备工作

1. 环境检查：确保已安装Docker环境，并确认当前SurveyKing版本支持MySQL配置
2. 资源准备：准备MySQL服务器（可以是独立服务器或Docker容器）
3. 备份策略：在进行任何数据库操作前，务必备份现有H2数据库文件

MySQL数据库配置

首先需要设置MySQL服务：

1. 使用Docker启动MySQL容器（若选择容器化部署）：

docker run --name surveyking-mysql -e MYSQL_ROOT_PASSWORD=yourpassword -p 3306:3306 -d mysql:latest

2. 创建专用数据库和用户：

CREATE DATABASE surveyking_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'surveyking_user'@'%' IDENTIFIED BY 'userpassword';
GRANT ALL PRIVILEGES ON surveyking_db.* TO 'surveyking_user'@'%';
FLUSH PRIVILEGES;

SurveyKing配置修改

修改SurveyKing的Docker运行配置，添加MySQL连接参数：

docker run -d \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql-server:3306/surveyking_db?useSSL=false&serverTimezone=UTC" \
  -e SPRING_DATASOURCE_USERNAME=surveyking_user \
  -e SPRING_DATASOURCE_PASSWORD=userpassword \
  -e SPRING_JPA_HIBERNATE_DDL_AUTO=update \
  --name surveyking \
  -p 8080:8080 \
  javahuang/surveyking:latest

关键参数说明：

• SPRING_DATASOURCE_URL：MySQL连接字符串
• SPRING_DATASOURCE_USERNAME/PASSWORD：数据库认证信息
• SPRING_JPA_HIBERNATE_DDL_AUTO=update：自动更新数据库 schema

数据迁移策略

对于已有数据的系统，可采用以下迁移方案：

1. 导出H2数据：使用SurveyKing内置的数据导出功能
2. 初始化MySQL：启动新配置的SurveyKing实例，自动创建表结构
3. 导入数据：通过管理界面或API导入之前导出的数据

生产环境建议

1. 定期备份：设置MySQL的定期备份策略
2. 性能优化：根据问卷数量调整MySQL配置参数
3. 监控设置：添加对数据库连接池和查询性能的监控
4. 高可用考虑：对于关键业务，考虑MySQL主从复制或集群部署

常见问题解决

1. 字符集问题：确保MySQL使用utf8mb4字符集以支持完整Unicode
2. 时区配置：统一应用和数据库的时区设置
3. 连接池配置：根据并发量调整连接池大小
4. 版本兼容性：确认SurveyKing版本与MySQL版本的兼容性

通过以上步骤，用户可以顺利完成SurveyKing从H2到MySQL的迁移，获得更稳定、更易管理的数据库环境，为业务增长提供可靠的数据支撑。