从Wagtail 2.15.6升级至4.2.2后，报表/工作流功能报错

安全阿岳

2026-7-22

问题分析与解决方案

这个错误的核心是Django ORM的add_fields方法预期接收字符串格式的字段路径（比如requested__pk），但当前传入了Cast(F('id'))表达式对象，导致调用split方法时触发AttributeError。结合Wagtail版本升级（2.15.6 → 4.2.2）的背景，问题大概率出在工作流报表相关的自定义代码或未适配新版本的扩展逻辑中。

排查与修复步骤：

定位报错源头：
追踪调用add_fields的代码位置，重点检查项目中自定义的WorkflowReport、WorkflowTaskReport子类，或重写的get_queryset、get_columns、get_table_data等报表相关方法，确认哪里将Cast表达式直接作为字段名传入了ORM方法。
修复字段引用逻辑：
如果是自定义代码中使用了表达式注解（比如annotate(cast_id=Cast(F('id'), ...))），确保在报表列定义或ORM查询中，传递给add_fields的是字符串格式的字段名（比如'cast_id'），而非Cast对象本身。例如：
```
# 错误示例：直接传入表达式对象
query.add_fields(Cast(F('id'), output_field=IntegerField()))

# 正确示例：使用注解后的字段名字符串
query.annotate(cast_id=Cast(F('id'), output_field=IntegerField()))
query.add_fields('cast_id')
```
适配Wagtail 4.x报表API：
Wagtail 4.x的报表系统相较于2.x有API调整，比如ReportView的列定义方式、查询构造逻辑变化。如果项目中有自定义报表，对照Wagtail官方文档调整实现，确保所有列的field属性为字符串字段路径，而非表达式对象。
检查核心依赖补丁：
若排查后确认是Wagtail核心代码的问题（概率较低），优先升级到Wagtail 4.2.x的最新小版本（如4.2.6），看官方是否已修复该兼容性bug；若无法升级，可临时通过猴子补丁修正add_fields的参数处理逻辑，将表达式对象转换为对应的字段名。