MySQL JSON字段在CakePHP迁移中需绕过modifyColumn，改用原生SQL执行MODIFY COLUMN；插入数据须用JSON_OBJECT等函数确保有效性；模型读取需手动json_decode；跨版本迁移要注意JSON函数行为差异。
MySQL JSON 字段在 CakePHP migration 中不能直接用 modifyColumn
因为 CakePHP 的 modifyColumn() 底层生成的是 ALTER TABLE ... CHANGE COLUMN，而 MySQL 对 JSON 类型字段禁止直接 CHANGE 或 MODIFY（会报 ERROR 1832 或 ERROR 1064）。哪怕只是想改个默认值或注释，也会失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 改字段类型/约束必须拆成两步：先
removeColumn('col')，再addColumn('col', 'json', [...]) - 若需保留原数据，得在
up()里手动用$this->execute()执行原生 SQL：ALTER TABLE table_name MODIFY COLUMN col JSON（注意：仅适用于 MySQL ≥ 5.7.8，且目标列当前确实是 JSON） - 不要依赖
changeColumn()—— CakePHP 的 Schema 构建器不识别 JSON 类型语义，它会试图按字符串逻辑处理，导致语法错误
CakePHP migration 写入 JSON 字段值时被当成字符串转义
当你在 up() 里用 $this->insert() 往 JSON 字段插入 '{"status":"active"}'，MySQL 实际存的是带双引号的字符串，而不是合法 JSON 值。后续调用 JSON_VALID() 返回 0，所有 -> 操作都失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须用 MySQL 原生函数写入：
$this->execute("INSERT INTO table (id, config) VALUES (1, JSON_OBJECT('status', 'active'))") - 避免拼接 JSON 字符串；若必须动态构造，用
json_encode($php_array, JSON_UNESCAPED_UNICODE)生成字符串后，再套一层JSON_SET()或CAST(... AS JSON) - 迁移执行后立刻验证：
$this->execute("SELECT id, JSON_VALID(config) FROM table WHERE id = 1")，确保返回 1
迁移后 CakePHP 模型读取 JSON 字段仍是字符串，不是数组
CakePHP 不像 ThinkPHP 那样提供 $json 属性自动反序列化。即使数据库字段是 JSON 类型，模型查出来仍是字符串，$entity->config['status'] 会报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在实体类中定义访问器：
protected $_accessible = ['config' => true];+protected function _getConfig($value) { return $value === null ? null : json_decode($value, true); } - 若用视图层（如模板），可配合
toArray()后手动json_decode，但别在控制器里反复 decode - 不推荐全局修改
Table::find()的结果集 —— CakePHP 的 ORM 不拦截原始字段值，必须显式处理
跨版本迁移时 JSON 函数行为差异引发视图或查询失败
从 MySQL 5.7 迁到 8.0 后，原有视图或 migration 中写的 JSON_EXTRACT(config, '$.status') 可能返回 NULL，即使数据存在。原因是 MySQL 8.0+ 默认将 JSON 路径提取结果当作标量类型处理，和字符串比较时隐式转换失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在 migration 的 SQL 语句中显式转类型：
CAST(JSON_EXTRACT(config, '$.status') AS CHAR) - 检查视图定义是否含
JSON_CONTAINS、JSON_LENGTH等函数——它们在 8.0+ 行为更严格，空 JSON 数组[]和 NULL 不再等价 - 避免在 migration 中依赖视图逻辑；若必须用，先在目标库手动执行
SHOW CREATE VIEW，确认函数可用后再写进 migration
up() 的每一条 SQL 是否经过 JSON_VALID() 验证。漏掉这一环，上线后才发现字段内容不可解析，比改表结构还难回滚。 
