Frappe集成PostgreSQL访问Web Form路由遇ValidationError问题

错误核心分析 #

根据回溯信息，错误根源是Web Form的Condition JSON字段被存储为列表类型，但Frappe期望该字段为JSON对象（字典结构）。PostgreSQL对JSON类型的校验比MySQL更严格，因此在MySQL中可能被允许的列表值，在PostgreSQL环境下触发了ValidationError。

解决步骤 #

• 检查并修正Web Form字段值
  进入Frappe后台，找到目标Web Form文档，查看Condition JSON字段内容。如果是[]这类空列表或列表结构，直接修改为{}（空JSON对象）或符合业务需求的键值对JSON结构。

• 直接修复数据库数据
  若后台修改后问题仍存在，可直接操作PostgreSQL数据库修正数据：

  UPDATE "tabWeb Form" SET "condition_json" = '{}' WHERE "name" = '你的Web Form名称';
  

  替换语句中的你的Web Form名称为实际的Web Form文档名称。

• 验证Frappe版本兼容性
  确认当前Frappe版本是否完全支持PostgreSQL，部分旧版本在JSON字段处理上存在兼容性问题。建议升级到v14及以上的稳定版本，升级后重新测试Web Form访问。

• 排查自定义代码/第三方应用
  检查是否有自定义代码在设置condition_json时错误传入了列表类型；逐一禁用第三方应用，排查是否是插件导致的字段值类型异常。

内容的提问来源于stack exchange，提问作者Prajwal Dhoble