Grafana默认SQLite3因文件级锁不支持并发写入，易触发“database is locked”错误；缓解措施包括调大busy_timeout、禁用非必要写行为、清理session表；根治方案是迁移至MySQL，需停服备份、Grafana自动建表、清洗SQL后导入，并配置连接池与权限。
Grafana 默认使用 SQLite3 作为后端数据库，轻量便捷但不支持真正的并发写入——同一时刻仅允许一个写事务，且锁粒度是整个数据库文件。当多个用户同时操作（如保存看板、更新告警规则、刷新会话），或 Grafana 实例频繁写入（尤其在高频率定时任务、嵌入式页面自动刷新场景下），极易触发 database is locked 错误，表现为看板无法保存、登录失败、API 返回 500、UI 卡顿等现象。
直接缓解 SQLite3 锁死的临时措施
若暂不能迁移，可先降低锁冲突概率：
-
调大 SQLite3 的 busy timeout：在
grafana.ini的[database]段添加sqlite3_busy_timeout = 10000（单位毫秒），让写操作等待更久再报错，治标不治本但能缓解突发高峰； -
禁用非必要写行为：关闭自动保存草稿（
editors_can_admin = false）、限制匿名用户编辑权限、停用未使用的插件（尤其含后台同步逻辑的）； -
定期清理 session 表：SQLite3 中
session表若长期堆积大量过期记录，会拖慢写入。可手动执行DELETE FROM session WHERE expiry 并 <code>VACUUM;； - 避免在脚本中高频调用 Grafana API 写接口：如批量导入看板时，加 100–500ms 间隔，防止瞬间写请求压垮 SQLite。
迁移到 MySQL 的核心步骤（推荐生产环境采用）
迁移目标不是简单“换存储”，而是获得真正的并发支持、跨实例共享、备份恢复能力与高可用基础。关键在于表结构由 Grafana 自建、数据清洗后再导入，而非直接 dump/restore。
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
-
停服务并备份原库：执行
systemctl stop grafana-server，然后复制/var/lib/grafana/grafana.db（路径以实际配置为准）为备份； -
创建兼容的 MySQL 数据库：使用
utf8mb4字符集和utf8mb4_general_ci排序规则，例如：CREATE DATABASE grafana DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; -
配置 Grafana 指向 MySQL 并启动初始化：修改
/etc/grafana/grafana.ini，启用 MySQL 配置（推荐用url格式）：url = mysql://grafana:your_password@127.0.0.1:3306/grafana
保存后执行systemctl start grafana-server—— 此步会让 Grafana 自动创建符合其版本要求的表结构（含索引、字段类型、约束），避免手动建表不兼容； -
导出并清洗 SQLite 数据：用脚本导出（如
sqlite3 grafana.db .dump > raw.sql），然后删除开头的PRAGMA和BEGIN TRANSACTION行，替换所有AUTOINCREMENT为AUTO_INCREMENT，去除双引号/反引号包裹的表名和字段名，并移除 TEXT/BLOB 字段上的DEFAULT值（如uid TEXT NOT NULL DEFAULT ''→uid TEXT NOT NULL）； -
导入清洗后的 SQL 到 MySQL：登录 MySQL，执行
USE grafana;后运行source clean_grafana.sql。注意跳过session表（Grafana 启动后会重建）和migration_log表（可能引发版本冲突）； -
验证并重启：确认
SELECT COUNT(*) FROM user;等关键表数据量正常，然后systemctl restart grafana-server，检查日志无报错、Web 界面可正常登录及保存看板。
迁移后需注意的细节
MySQL 不是“一配了之”，还需配套调整：
-
MySQL 用户权限要精确：授予
grafana用户对grafana.*的SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER权限，但不要给GRANT OPTION或全局权限； -
连接池参数建议显式配置：在
grafana.ini的[database]下添加：max_open_conns = 10max_idle_conns = 5conn_max_lifetime = 14400（单位秒），防连接泄漏； -
监控 MySQL 连接与慢查询：启用
slow_query_log，重点关注INSERT INTO alert_rule、UPDATE dashboard类语句是否变慢，及时加索引； -
若用 TiDB 替代 MySQL：语法基本兼容，但需确认 TiDB 版本 ≥ 5.4，且关闭
enable-table-lock，避免引入新锁机制。
迁移本身不复杂，但容易忽略表结构适配与数据清洗环节。只要确保 Grafana 先建好表、再灌数据，就能避开 90% 的导入失败问题。
