在 PHP 7.4 、MySQL 5.7 中，插入 json 类型的字段，成功插入值 string(4) “null” 的分析（与 json_encode(null) 有关）

1、在 MySQL 表，字段类型为 json，允许为 NULL。如图1

图1

CREATE TABLE `table` (
  `schema` json DEFAULT NULL COMMENT '主题的Schema，包括页面、主题级别、组件级别',
);

2、由于在程序中仅判断了 is_null()，如果不为 NULL，则默认为 json 格式。当其值为 string(4) “null” 时，程序抛出 500 异常。显示为 null，表示其值为 string(4) “null”，不符合预期。显示为 (Null)，表示其值为 NULL，符合预期。如图2

图2

3、从日志中查看生成的 SQL，确认在更改表中记录中，赋值为 ‘null’。如图3

图3

update
  `table`
set
  `schema` = 'null',
  `checksum` = '0821db9eefeab3d74bbbac6f58cd68e4c8f1b9e2',
  `table`.`updated_at` = '2023-04-21 03:41:48'
where
  `id` = 432070

4、打印生成 SQL 处的相关变量的变化情况。结果如下。如图4

图4

$schema1 = $themeAsset->schema;
$schema2 = $this->themeSettingMigration->migrateJsonTemplate($filename, $schema, $themeInstallationTask, $availableVersions);
$themeAsset->schema = json_encode($schema2);
Log::info(
	$themeAsset->id,
	[
		'schema1' => $schema1,
		'schema2' => $schema2,
		'schema3' => $themeAsset->schema,
	]
);

[2023-04-21 11:41:48] local.INFO: 432062 {
    "schema1": null,
    "schema2": null,
    "schema3": "null"
} 

5、由此得出结论，当 json_encode(null) 时，会返回 ‘null’，并且最终会 SQL 更新为值 ‘null’。决定调整如下，添加判断，当不为 NULL 时，才执行 json_encode，否则返回 NULL

$schema = $this->themeSettingMigration->migrateJsonSettingsData($configSettingsDataSchema, $themeInstallationTask, $availableVersions);
$configSettingsData->schema = $schema ? json_encode($schema) : null;