BIRT报表运行报错：列绑定“Name”引用不存在的数据集列

报错信息与堆栈（翻译后） #

报错：Error org.eclipse.birt.report.engine.api.EngineException: 列绑定"Name"引用了一个不存在的数据集列"Name"

错误堆栈：

at org.eclipse.birt.report.engine.executor.ExecutionContext.addException(ExecutionContext.java:1245)
at org.eclipse.birt.report.engine.executor.ExecutionContext.addException(ExecutionContext.java:1224)
at org.eclipse.birt.report.engine.executor.QueryItemExecutor.executeQuery(QueryItemExecutor.java:96)

问题：如何定位报表中该报错指向的列绑定？

定位步骤 #

• 先检查数据源与数据集
  打开报错的BIRT报表，切换到「数据源/数据集视图」，找到对应数据集，查看其返回列列表——确认是否真的没有Name列，可能是拼写错误、大小写不匹配，或是数据集SQL修改后删除了该列。

• 用列绑定视图全局检索

  1. 在BIRT设计器中打开「列绑定（Column Bindings）视图」（未显示可通过Window > Show View > Other调出）。
  2. 在视图搜索框输入Name，快速定位所有同名列绑定，逐一检查它们的「数据集列」引用是否指向了不存在的Name列，或是绑定的数据集本身有误。

• 排查引用该绑定的报表元素

  1. 通过设计器的「Outline视图」，搜索使用Name字段的报表元素（表格、列表、文本框等）；也可右键元素选择Show in > Column Bindings直接关联到绑定配置。
  2. 选中元素后，在属性视图的「绑定」标签页，查看Name绑定的数据源配置是否正确。

• 使用设计器验证功能
  点击设计器顶部的「验证（Validate）」按钮，设计器会自动扫描报表内所有绑定错误，直接列出问题位置与对应元素，快速定位问题点。

内容的提问来源于stack exchange，提问作者Debra Ingleson