MySQL Workbench 1175错误：安全更新模式解决全攻略
2025-03-08 08:48:41
MySQL Workbench 更新数据报错 1175：安全模式惹的祸！
最近在用 MySQL Workbench 更新数据时，遇到了一个错误提示：Error Code: 1175. You are using safe update mode and you tried to update a table without a WHERE that uses a KEY column...。 即使按照提示禁用了安全更新模式，问题依旧。这究竟是怎么回事？ 别急，下面就来帮你解决！
一、问题出在哪儿？
简单说，MySQL Workbench 为了防止用户误操作，比如不小心执行了没有 WHERE 子句的全表更新，默认开启了“安全更新模式”（Safe Update Mode）。
这个模式要求 UPDATE 和 DELETE 语句必须包含 WHERE 子句，并且 WHERE 子句中必须使用到键列（比如主键或唯一索引）。 如果 WHERE 后面跟的不是 KEY，或者干脆没有WHERE，就会报 1175 错误。
就算在 Workbench 的设置里关闭了安全更新（Edit -> Preferences -> SQL Editor -> 取消勾选 Safe Updates），有时也 不一定 能立即生效。这可能是因为 Workbench 的会话设置，或者 MySQL 服务器全局设置的影响。
二、解决办法，多种选择任你挑！
下面提供几种解决方案，你可以根据自己的实际情况选择：
1. 最稳妥的办法：加上 WHERE 条件！
这是最符合安全更新模式要求的做法。只要你的 UPDATE 语句有 WHERE 条件，并且条件里用到了主键或唯一键，就不会报错。
例如，假设表 tablename 的主键是 id，你想把 id 为 1 的那行数据的 columnname 字段更新为 1：
UPDATE tablename SET columnname = 1 WHERE id = 1;
如果需要根据其他条件去更新，需要确认条件字段建立了索引：
UPDATE tablename SET columnname = 1 WHERE othercolumn = 'somevalue'; -- othercolumn上最好有索引
原理： 这是最安全、最规范的做法，能有效防止误操作。
安全建议： 强烈推荐使用这种方法。
2. 临时关闭当前会话的安全更新模式
如果你 确定 你的 UPDATE 语句没问题，只是想临时绕过安全更新的限制，可以在当前会话中执行以下命令：
SET SQL_SAFE_UPDATES = 0;
-- 然后执行你的 UPDATE 语句
UPDATE tablename SET columnname = 1;
-- 操作完成后，可以再把安全模式打开（可选）
SET SQL_SAFE_UPDATES = 1;
原理： SQL_SAFE_UPDATES 是一个会话变量，只影响当前连接。设置 SQL_SAFE_UPDATES = 0 就关闭了当前会话的安全更新。
注意点：
- 这种方法只对当前连接有效。关闭 Workbench 重新连接后，安全更新会恢复默认开启状态。
- 修改完之后, 最好设置回去
SET SQL_SAFE_UPDATES = 1;。
3. 通过 Workbench 的设置关闭安全更新（有时不生效）
前面提到了，有时候直接在 Workbench 的设置里关闭安全更新可能无效。但你可以先试试这个方法，步骤如下：
- 打开
Edit->Preferences。 - 点击
SQL Editor。 - 取消勾选
Safe Updates (rejects UPDATEs and DELETEs with no restrictions)。 - 点击
OK。 - 重要： 重启 MySQL Workbench！
原理： 理论上，这个设置会修改 Workbench 的全局设置，关闭安全更新。但由于各种原因（比如服务器设置），可能不会立即生效或完全不生效。
补充: 关闭 Workbench 之后重试.
4. 修改 MySQL 服务器全局设置（不推荐）
如果以上方法都无效，你 可以 考虑修改 MySQL 服务器的全局设置。但强烈不推荐 这样做，因为会影响 所有 连接到这个服务器的用户，可能带来安全隐患。
如果一定要这么做，可以执行以下命令（需要管理员权限）：
SET GLOBAL SQL_SAFE_UPDATES = 0;
设置之后, 需要断开重连.
原理： GLOBAL 表示修改的是全局变量，会影响所有连接。
安全警告： 这种做法有很大风险，不推荐普通用户使用。除非你是数据库管理员，并且清楚自己在做什么，否则不要轻易修改全局设置。
操作完成后，务必记得设置回去：
SET GLOBAL SQL_SAFE_UPDATES = 1;
5. 使用其他 MySQL 客户端
如果问题只出现在 MySQL Workbench，可以尝试使用其他 MySQL 客户端，比如：
- 命令行客户端（mysql）: 最基础也最强大的工具。
- DBeaver: 免费开源的数据库管理工具，支持多种数据库。
- DataGrip: JetBrains 出品的专业数据库 IDE（收费）。
- Navicat: 老牌数据库工具.
这些客户端可能默认没有开启安全更新模式，或者更容易配置。
原理： 不同客户端的默认设置和行为可能不同。
进阶使用：巧用 LIMIT
如果一定需要在没有使用到 Key column 的情况下做批量更新,可以使用LIMIT 做数量限制, 这能极大避免全表更新误操作。
UPDATE tablename SET columnname = 1 LIMIT 100;
但是前提还是关闭当前会话安全模式 SET SQL_SAFE_UPDATES = 0; 。即使设置了LIMIT，在SQL_SAFE_UPDATES = 1下还是会报错。
最佳实践
还是加上WHERE 条件最安全可靠, 例如,给表新增一个update_flag的字段用于范围更新:
UPDATE tablename SET columnname=1 where update_flag = 0 LIMIT 100;
分批更新之后, 再去修改update_flag 的值, 继续操作下一批。
三、小结
遇到 MySQL Workbench 的 1175 错误，不要慌。先搞清楚安全更新模式的作用，再选择合适的解决方案。 最好的解决办法是使用 WHERE， 其次是针对 session 设置SQL_SAFE_UPDATES = 0; 。 如果只是需要单次更新，可以直接在条件允许下修改表数据。
