PostgreSQL中从JSON迁移至JSONB是否安全？JSON转JSONB是否始终向后兼容？

好问题！我之前也帮团队做过JSON转JSONB的迁移，结合PostgreSQL的实际使用经验，给你梳理下兼容性的情况：

核心结论 #

绝大多数原生SQL操作在JSON转JSONB后是完全向后兼容的，但有几个细节需要留意，避免踩坑。

1. 常用操作符与函数的兼容性 #

• 基础查询操作符：->（提取JSON对象字段，返回JSON类型）、->>（提取字段并返回文本）、#>（按路径提取）、#>>（按路径提取文本）这些最常用的操作符，对JSON和JSONB的支持完全一致。比如你之前写的：

  SELECT user_data->'profile'->>'username' FROM users;
  

  转成JSONB字段后直接运行，结果和之前完全一样。
• 通用JSON函数：像json_array_length、json_extract_path、json_object_keys这类不带jsonb_前缀的函数，会自动兼容JSON和JSONB类型——PostgreSQL会隐式做类型转换，不需要修改函数调用。

2. 需要注意的差异点 #

• 比较逻辑的细微区别：JSON类型是按原始文本做比较，而JSONB是按结构化内容比较。比如：

  -- JSON类型下，因为空格不同，返回false
  SELECT '{"name": "Alice"}'::json = '{"name":"Alice"}'::json;
  
  -- JSONB类型下，忽略格式差异，返回true
  SELECT '{"name": "Alice"}'::jsonb = '{"name":"Alice"}'::jsonb;
  

  如果你的SQL里依赖了JSON的文本比较逻辑（比如判断两个JSON的原始字符串是否完全一致），转成JSONB后需要调整，比如用::text显式转成文本再比较。
• 边缘函数的兼容性：极少数底层函数（比如json_in、json_out）是专门针对JSON类型的，这类函数在业务SQL里几乎不会用到，如果你没用到这类函数可以忽略。

3. DML操作的兼容性 #

插入、更新、删除操作完全兼容：

• 你可以直接把原来的JSON类型值插入到JSONB字段，PostgreSQL会自动完成类型转换，比如：

  -- 原来的插入语句，转成JSONB字段后依然有效
  INSERT INTO orders (metadata) VALUES ('{"status": "pending"}'::json);
  

• 更新操作同理，比如UPDATE orders SET metadata = metadata || '{"updated_at": "2024-05-20"}'::json;，转成JSONB后也能正常运行。

4. 索引相关的注意事项 #

虽然这不属于SQL操作的兼容性问题，但还是提一句：原来的JSON字段如果建了索引，转成JSONB后需要重建索引（比如把JSON的GIN索引改成JSONB的GIN索引），不过这不会影响你的业务SQL代码，只是需要做一次索引迁移。

总结 #

只要你的SQL没有依赖JSON类型的原始文本比较逻辑，转成JSONB后几乎不需要修改任何代码，完全向后兼容。建议先在测试环境跑一遍所有核心SQL脚本，验证没有问题后再在生产环境迁移。

内容的提问来源于stack exchange，提问作者Vladyslav Zavalykhatko