peewee 会覆盖 mysql 的全局 sql 模式，导致严格模式失效
在使用 Peewee 操作 MySQL 时，一个容易被忽视但影响深远的问题是：即使 MySQL 已启用严格 SQL 模式（如 TRADITIONAL、STRICT_TRANS_TABLES 或 STRICT_ALL_TABLES），Peewee 仍可能绕过约束，静默插入不完整数据——例如对 null=False 且无默认值的字段传入 None 或完全省略，最终写入空字符串、零值或 0000-00-00 00:00:00 等非法占位值，而非抛出预期的完整性错误。
根本原因在于 Peewee 的 MySQLDatabase 类（源码第 4147 行）硬编码了 sql_mode = "PIPES_AS_CONCAT"，并在建立连接时将其作为连接参数传递。该行为会完全覆盖 MySQL 服务端的全局 sql_mode 设置（包括你通过 SET GLOBAL sql_mode="TRADITIONAL" 配置的严格模式），从而禁用关键的严格校验逻辑。
例如，以下模型定义中 last_name 明确为 null=False：
class Person(Model):
first_name = CharField(32)
last_name = CharField(32, null=False) # ← 必填，无默认值
class Meta:
database = debug_db当仅传入 first_name 创建实例并调用 .save() 时：
Person(first_name="John").save() # ✅ 静默成功 —— 但不应如此！
Peewee 生成的 SQL 仅为 INSERT INTO person (first_name) VALUES ('John')，而 MySQL 在严格模式下本应拒绝该语句（报错 ERROR 1364: Field 'last_name' doesn't have a default value）。但由于 Peewee 覆盖了 sql_mode，实际生效的是非严格模式，导致数据损坏风险。
✅ 正确解决方案
方案一：显式声明 sql_mode（推荐）
在初始化 MySQLDatabase 时，直接指定你所需的严格模式（无需依赖全局配置）：
debug_db = MySQLDatabase(
database='debug_db',
user='DEBUG',
host='localhost',
password='secret',
sql_mode='TRADITIONAL', # 或 'STRICT_TRANS_TABLES'
)✅ TRADITIONAL 是 MySQL 官方推荐的严格模式组合，等价于 STRICT_TRANS_TABLES, STRICT_ALL_TABLES, NO_ZERO_DATE, NO_ZERO_IN_DATE, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER, NO_ENGINE_SUBSTITUTION。
方案二：保留 PIPES_AS_CONCAT 并追加严格模式（进阶）
若你依赖 PIPES_AS_CONCAT（如使用 || 作字符串拼接），又不想丢失全局严格模式，可禁用 Peewee 的 sql_mode 覆盖，并通过 init_command 动态追加：
debug_db = MySQLDatabase(
database='debug_db',
user='DEBUG',
host='localhost',
password='secret',
sql_mode=None, # ← 关键：禁用 Peewee 的硬编码覆盖
init_command="SET sql_mode=(SELECT CONCAT(@@sql_mode,',PIPES_AS_CONCAT'));"
)该方案利用 MySQL 的 @@sql_mode 变量读取当前会话/全局模式，并安全拼接 PIPES_AS_CONCAT，确保两者共存。
⚠️ 注意事项与验证
- 不要依赖 SET GLOBAL sql_mode：Peewee 连接级参数优先级高于全局设置，必须在连接初始化时显式控制。
- 验证是否生效：连接后执行 SELECT @@sql_mode 确认结果包含 STRICT_TRANS_TABLES 等关键词。
- SQLite 行为不同：SQLite 驱动在 Peewee 中会主动检查 null=False 并提前抛出 IntegrityError，而 MySQL 驱动将校验权完全交由服务端 SQL 模式控制——因此MySQL 下必须靠 sql_mode 保障数据完整性。
- 版本兼容性：该问题存在于 Peewee 3.x 全系列（含 3.17+），MySQL 5.7/8.0 均受影响。
总结
Peewee 对 MySQL 的 sql_mode 强制覆盖是一个设计权衡（为兼容旧版语法），但在现代应用开发中极易引发数据一致性隐患。最佳实践是始终在数据库实例化时显式声明 sql_mode，明确启用严格模式。这不仅是修复静默插入的补丁，更是构建健壮 ORM 层的关键防线——让数据库真正成为数据质量的最后一道闸门。
