通过

排查添加数据源的问题（预览版）

本文提供 PAC CLI（Power Apps 命令行接口） pac 代码 add-data-source 命令失败时的故障排除步骤。

症状

由于计算机或网络上的某些内容正在阻止连接或中断身份验证，因此通常会发生故障。

症状 示例消息
提取失败 Fetch Failed （无其他堆栈）
超时/网络错误 ETIMEDOUT、ENOTFOUND、ECONNRESET
环境不匹配 找不到数据源/意外架构

先决条件

  1. 验证是否已 安装最新的 Power Platform CLI。 如果不确定，请对其进行更新。
  2. 请确认您已认证到正确的环境。 使用 pac auth create 和 pac auth list 命令。
  3. 验证网络是否允许对 Power Platform 终结点进行出站 HTTPS 调用。

故障排除步骤

若要诊断根本原因，请执行以下步骤：

步骤 1：验证配置

打开 power.config.json 文件并确认：

  • environmentId 匹配您要目标的环境。
  • region 设置为 prod，除非你有意针对另一个区域。 若缺失请添加。

步骤 2：交叉检查环境上下文

运行 pac env who 命令。

将输出中的值 Environment ID 与 environmentId 值 power.config.json进行比较。

示例输出（批注）：

Connected as user@domain.com
Organization Information
  Org ID:                     00aa00aa-bb11-cc22-dd33-44ee44ee44ee
  Unique Name:                unq2889ab2be728ef118406000d3a33f
  Friendly Name:              User Name
  Org URL:                    https://myorg.crm.dynamics.com/
  User Email:                 user@domain.com
  User ID:                    aaaaaaaa-bbbb-cccc-1111-222222222222
  Environment ID:             aaaabbbb-0000-cccc-1111-dddd2222eeee  <-- Ensure this matches

相应的 power.config.json 示例代码片段：

{
  "environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "region": "prod"
}

步骤 3：重新运行命令

重新运行 pac code add-data-source 命令。 例如：

pac code add-data-source -a dataverse -t account

在输出中查找 HTTP 状态代码或错误消息。

步骤 4：网络安全验证

如果仍然失败：

验证浏览器连接性

此步骤有助于确认用户帐户具有正确的权限，并且可从计算机访问数据源。

  1. 在使用 PAC CLI 的同一台计算机上打开 Web 浏览器。
  2. 直接导航到要添加的数据源。 例如，SharePoint 网站或 Dataverse 环境 URL。
  3. 使用与 PAC CLI pac auth create 命令验证时相同的凭据登录
  4. 如果无法访问资源，则用户帐户的权限问题可能是根本原因。
  5. 如果可以访问它，请移动到 “分析网络流量”。

分析网络流量

这是查看 PAC CLI 与数据源终结点之间的原始网络通信数据的最有效方法。

  1. 下载并安装 Fiddler Classic。 Fiddler 是监视网络流量的工具。

  2. 启动 Fiddler 并确保其正在捕获流量。 转至文件>捕获流量。

  3. 在命令提示符中，运行失败 pac code add-data-source 的命令。

  4. 在 Fiddler 会话列表中，查找对数据源终结点发出的请求。 例如：yourorg.crm.dynamics.com 或 yourtenant.sharepoint.com。

  5. 分析响应信息：

    • 200状态代码指示成功。
    • 401 （未授权）或403（禁止）状态代码指向身份验证或权限问题。
    • 其他错误代码或完全缺少响应可能指示防火墙或代理正在阻止请求。

步骤 5：清除/重置身份验证上下文

如果检测到不匹配，则应使用以下 PAC CLI 命令清除或重置身份验证上下文。

pac auth list
pac auth select --index <n>
pac env who

如果不正确，请重新进行身份验证：

pac auth create --environment <yourEnvironmentId>

升级数据

在联系技术支持提出问题之前，请收集以下数据。

提供：

  • CLI 版本。 使用pac --version命令
  • 操作系统和命令行界面（Windows cmd / PowerShell / WSL）
  • 使用的完整命令
  • 消毒过的调试日志输出摘录
  • power.config.json 在编辑机密信息后
  • Last updated on