PowerBI语义模型报错‘FieldCaption列未找到’的解决方法咨询

核心排查与解决步骤 #

报错The column ‘FieldCaption’ of the table wasn’t found并非来自原始数据源，大概率是Data Flow Gen1内部逻辑、语义模型配置或服务缓存导致的残留引用，以下是具体操作方案：

1. 检查Data Flow Gen1的查询逻辑 #

• 进入Data Flow Gen1的查询编辑器，逐步骤排查M代码，确认是否存在自定义列生成、合并/追加表、引用系统视图等操作误创建了FieldCaption列，或引用了包含该列的隐藏对象。
• 若无法定位可疑步骤，可将数据流查询导出至Power BI Desktop，在Desktop中逐行检查M代码，删除所有涉及FieldCaption的逻辑后重新发布数据流。

2. 验证语义模型的DAX配置 #

• 检查语义模型中的计算列、度量值、关系定义，确认DAX表达式中是否存在对FieldCaption的误引用（可能是旧版本模型残留的代码）。
• 若使用导入模式，在Power BI Desktop中打开已发布的模型文件，通过“查找”功能搜索FieldCaption，定位并删除相关引用后重新发布。

3. 清除Power BI服务端缓存 #

• 在工作区的语义模型设置中，选择“刷新”并勾选“清除缓存后刷新”。
• 重新发布模型时，选择“覆盖所有内容”，发布完成后立即触发一次完整刷新，覆盖服务端的旧元数据。

4. 排查数据源与网关配置 #

• 若使用MySQL自定义SQL查询，检查SQL语句中是否误包含了FieldCaption列，或引用了information_schema等系统库中的表（部分系统视图可能包含该字段）。
• 升级本地网关至最新的Power BI兼容版本（避免使用Fabric专属网关），旧网关版本可能与Data Flow Gen1存在元数据同步问题。

5. 隔离测试验证 #

• 跳过Data Flow Gen1，直接在Power BI服务中连接MySQL/Excel数据源创建测试语义模型，若未报错则可确认问题出在数据流环节。
• 查看Data Flow Gen1的历史运行日志，确认数据流刷新时是否生成了包含FieldCaption的错误输出表。

内容的提问来源于stack exchange，提问作者Jorn Meeusen