ERROR 1290在从库发生是因read_only与super_read_only双启用导致写类操作(含UDF执行)被内核拦截;二者须同时为OFF才可能执行,但生产环境禁用以防破坏主从高可用。

从库报 ERROR 1290 是因为 read_only + super_read_only 双重拦截
MySQL 从库执行写操作(包括 INSERT、UPDATE、DROP TABLE,甚至 CREATE FUNCTION)时抛出 ERROR 1290 (HY000): The MySQL server is running with the --read-only option so it cannot execute this statement,根本原因不是权限不足,而是服务端明确拒绝——它把当前实例识别为只读角色,并在语句解析阶段就拦截了所有可能改变状态的操作。
关键点在于:read_only = ON 仅拦普通用户;真正让 root 或 SUPER 用户也动不了的,是 super_read_only = ON。这两个变量必须同时检查:
-
SELECT @@global.read_only, @@global.super_read_only;—— 必须两个都为OFF才可能执行写入 - 云数据库(如阿里云 RDS、腾讯云 CDB)常屏蔽
super_read_only的动态设置,即使你SET GLOBAL super_read_only = OFF也会报错Variable 'super_read_only' is a read only variable -
super_read_only = ON会自动把read_only设为ON;但反过来,read_only = OFF会强制清空super_read_only,所以顺序不能错
UDF / 存储函数在从库执行失败不是权限问题,是内核策略
自定义函数(CREATE FUNCTION ... SONAME)或非确定性存储函数,在从库上调用时报 ERROR 1290,和账号权限完全无关。MySQL 内核把 UDF 执行视为「潜在写行为」:它要加载动态库、进入 THD 上下文、可能调用内部 API(比如 mysql_real_query()),而内核无法静态分析函数体是否真有副作用,所以一律按写操作拦截。
常见误判场景:
- 你确认函数里只做
sqrt()、CONCAT()这类纯计算,仍会失败 —— 因为注册行为本身(CREATE FUNCTION)就是 DDL,被归为写类语句 -
DETERMINISTIC标记对 UDF 无效,只对原生CREATE FUNCTION(SQL 函数)起作用;且必须同时满足:无外部依赖、不访问系统表、不调用随机/时间函数 - 即使你在主库开了
log_bin_trust_function_creators = ON并同步了函数定义,从库上函数“存在” ≠ “可执行”
别信 SET SESSION read_only = OFF,它根本没用
read_only 是全局动态变量,SET SESSION 对它完全无效。你执行 SET SESSION read_only = OFF 不会报错,但查 @@session.read_only 仍是 OFF(注意:session 级根本没有这个变量),而 @@global.read_only 值不变 —— 所以它既不生效,也不提示错误,纯属误导。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
真正能改的只有:
-
SET GLOBAL read_only = OFF—— 需SUPER或SYSTEM_VARIABLES_ADMIN权限 -
SET GLOBAL super_read_only = OFF—— 同样需要高权限,且必须在read_only = ON已生效的前提下才允许设为OFF - 但这两条命令一旦执行,会写入 binlog 并复制到从库,导致整个主从集群退出只读 —— 违反高可用前提,生产环境禁止这样做
表级只读(#1036 Table ‘xxx’ is read only)和实例级只读不是一回事
如果报的是 ERROR 1036 (HY000): Table 'xxx' is read only,这和 read_only 参数无关,属于文件系统层问题。典型触发场景是:直接拷贝 .frm / .ibd 文件到从库 data 目录后,没重置文件属主或权限,MySQL 进程(mysql 用户)无法写入对应表文件。
验证与修复步骤:
- 确认表文件属主:
ls -l /var/lib/mysql/dbname/tablename.*,必须是mysql:mysql - 检查磁盘空间:
df -h /var/lib/mysql,若使用率 ≥95%,MySQL 会自动静默开启read_only = ON,错误现象一模一样 - 刷新表缓存:
mysqladmin -u root -p flush-tables,强制释放表锁并重载元数据 - 必要时运行:
mysqlcheck -r dbname tablename -u root -p修复表结构标记
真正难处理的,是那些你以为“只是读”的操作:监控脚本里的 FLUSH STATUS、BI 工具连的 root 账号、Percona Toolkit 默认用 --user=root —— 它们绕过业务权限体系,直击内核,而 read_only 对它们形同虚设,除非你开了 super_read_only。










