Power BI数据源路径变更后刷新失败

Question

当Power BI数据源路径发生变更（如Excel或CSV文件从本地迁移至SharePoint或OneDrive），原有数据连接将失效，导致手动或计划刷新时报错“找不到文件”或“请求失败：基础连接已关闭”。此问题源于Power BI Desktop中硬编码的数据源路径未同步更新，且网关未能正确映射新地址。尤其在发布至Power BI Service后，若未重新配置数据源凭据或未在数据网关中注册新路径，刷新将持续失败。该场景在团队协作与生产环境部署中尤为常见，需系统性检查并更新数据源设置、认证信息及网关连接，方可恢复正常刷新。

Answer 1

一、问题背景与现象分析

当Power BI的数据源（如Excel或CSV文件）从本地路径迁移至云端存储（如SharePoint Online或OneDrive for Business）后，原有的数据连接往往无法自动识别新位置。用户在Power BI Desktop中设计报表时，通常使用硬编码的本地文件路径（例如：C:\Reports\sales_data.xlsx），一旦该文件被移至云存储，发布到Power BI Service后的计划刷新便会失败。

典型报错信息包括：

• "找不到文件"（File not found）
• "请求失败：基础连接已关闭"（The underlying connection was closed）
• "访问被拒绝"（Access denied）
• "凭据缺失或无效"（Credentials are missing or invalid）

这些错误的根本原因在于：Power BI Service运行于云端，无法直接访问企业内网或本地磁盘路径；即使通过本地数据网关（On-premises Data Gateway），若未正确配置新的云数据源URL及身份验证方式，也无法建立有效连接。

二、技术原理与架构影响

Power BI的数据刷新机制依赖于两个核心组件：

1. 数据源路径解析：Power Query引擎根据M语言脚本中的Source字段定位原始数据文件。
2. 身份认证与网关代理：对于非公共数据源，需通过数据网关进行安全转发，并提供正确的OAuth或Windows凭据。

当数据源从本地迁移到SharePoint时，其协议由file://变为https://，且认证模型由NTLM切换为Azure AD OAuth。若未更新Power Query中的源地址和凭据类型，网关将无法代理请求，导致“基础连接已关闭”等底层网络异常。

此外，在团队协作环境中，多个开发者可能基于不同版本的路径开发报表，造成生产环境部署时出现“路径漂移”问题。

三、诊断流程与关键检查点

为系统性排查此类问题，建议按以下流程执行：

步骤	检查项	工具/位置
1	确认当前数据源路径是否仍指向本地	Power BI Desktop → 数据源设置
2	验证新路径是否可通过浏览器访问	SharePoint文档库链接
3	检查Power BI Service中数据集的数据源凭据	Power BI门户 → 设置 → 数据源凭据
4	确认数据网关是否注册了目标云服务	本地网关管理应用
5	测试连接是否成功	网关管理界面中的“测试连接”功能
6	查看刷新历史日志中的详细错误	Power BI Service → 刷新历史记录
7	确认用户账户具有文件读取权限	Azure AD & SharePoint权限面板
8	检查M查询中是否存在静态路径引用	Power Query编辑器高级编辑器
9	评估是否启用了多因素认证（MFA）影响凭据存储	Azure AD条件访问策略
10	确认TLS版本兼容性（特别是旧版网关）	服务器.NET框架配置

四、解决方案与实施路径

解决路径变更引发的刷新失败，应遵循“更新本地→同步云端→配置网关→测试验证”的四步法：

// 示例：原始M代码片段（本地路径）
let
    Source = Excel.Workbook(File.Contents("C:\Reports\sales.xlsx"), null, true),
    Sheet1_Sheet = Source{[Item="Sheet1",Kind="Sheet"]}[Data]
in
    Sheet1_Sheet

// 更新后M代码（SharePoint在线路径）
let
    Source = Excel.Workbook(Web.Contents(
        "https://contoso.sharepoint.com/sites/Finance/Shared%20Documents/sales.xlsx",
        [Headers=[Authorization="Bearer "]]),
    null, true),
    Sheet1_Sheet = Source{[Item="Sheet1",Kind="Sheet"]}[Data]
in
    Sheet1_Sheet
    

实际操作中可采用如下策略：

• 在Power BI Desktop中使用“更改源”功能更新所有查询的根路径。
• 利用参数化数据源路径（创建“DataSourceURL”参数），提升可维护性。
• 在Power BI Service中重新输入凭据，选择“组织账户”登录模式。
• 确保数据网关服务账户具备访问目标SharePoint站点的权限。
• 启用网关群组并绑定相关数据集，避免孤立连接。

五、自动化与治理优化建议

为防止未来再次发生类似问题，推荐引入以下治理机制：

graph TD
            A[数据源迁移项目启动] --> B{源类型变更?}
            B -->|是| C[更新Power BI中数据源路径]
            B -->|否| D[跳过路径调整]
            C --> E[参数化URL地址]
            E --> F[提交至Dev环境测试]
            F --> G[部署至UAT环境]
            G --> H[在Service中配置凭据]
            H --> I[关联数据网关]
            I --> J[执行端到端刷新测试]
            J --> K[纳入CI/CD流水线监控]
            K --> L[定期审计数据源健康状态]

通过将数据源路径抽象为可配置参数，并结合Azure DevOps或GitHub Actions实现自动化部署与刷新测试，可显著降低人为失误风险。同时，建立数据资产目录，统一管理所有外部数据源的生命周期与访问策略，有助于提升企业级BI平台的稳定性与可扩展性。