当 Power Apps CLI pa app add data-source 命令失败时，请排查添加数据源的问题。 按照以下步骤确定配置、身份验证或网络问题，并成功添加数据源。
故障特征
由于计算机或网络上的某些内容正在阻止连接或中断身份验证，因此通常会发生故障。
| 问题 | 示例消息 |
|---|---|
| 提取失败 |
Fetch Failed （无其他堆栈） |
| 超时或网络错误 |
ETIMEDOUT、ENOTFOUND 或 ECONNRESET |
| 环境不匹配 | 未找到数据源或架构异常 |
先决条件
验证是否已安装最新的 Power Apps CLI。 如果不确定，请更新它。
使用
pa auth login登录，并使用pa auth status验证当前账户：pa auth login pa auth status验证网络是否允许对 Power Platform 终结点进行出站 HTTPS 调用。
排查数据源错误的步骤
若要诊断根本原因，请执行以下步骤。
步骤 1：验证配置
power.config.json打开该文件并确认：
-
environmentId与您要针对的环境匹配。 -
region设置为prod，除非你想要面向另一个区域。 如果缺少，请添加。
步骤 2：交叉检查环境上下文
使用 pa auth status 确认已激活正确的帐户：
pa auth status
将 power.config.json 中的 environmentId 与 Power Apps 环境 URL 中显示的环境 ID 进行比较。
示例 power.config.json 代码片段：
{
"environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"region": "prod"
}
步骤 3：重新运行命令
再次运行 pa app add data-source。 例如：
pa app add data-source --connector dataverse --table account
在输出中查找 HTTP 状态代码或错误消息。
步骤 4：网络安全验证
如果命令仍然失败：
- 确认没有公司代理或防火墙阻止 CLI 进程或其他非浏览器流量。
- 批准所需的 Power Platform 端点。 请参阅 Power Platform 连接要求。
验证浏览器连接性
此步骤有助于确认用户帐户具有正确的权限，并且可从计算机访问数据源。
- 在使用 Power Apps CLI 的同一台计算机上打开 Web 浏览器。
- 直接转到要添加的数据源，例如SharePoint网站或 Dataverse 环境 URL。
- 使用
pa auth status显示的同一账户登录。 - 如果无法访问资源，则用户帐户的权限问题可能是根本原因。
- 如果可以访问它，请继续 分析网络流量。
分析网络流量
使用网络监视工具检查 Power Apps CLI 与数据源终结点之间的通信。
下载并安装 Fiddler Classic。
启动 Fiddler 并确保其正在捕获流量。 转至文件>捕获流量。
在命令提示符中，运行失败
pa app add data-source的命令。在 Fiddler 会话列表中，查找对数据源终结点发出的请求，例如
yourorg.crm.dynamics.com或yourtenant.sharepoint.com。分析响应：
-
200状态代码指示成功。 -
401（未授权）或403（禁止）状态代码指向身份验证或权限问题。 - 其他错误代码或完全缺少响应可能指示防火墙或代理正在阻止请求。
-
步骤 5：清除或重置身份验证上下文
如果错误的帐户处于活动状态，请使用 pa auth switch：
pa auth switch
如果未列出帐户，请使用 pa auth login：
pa auth login
若要清除所有保存的身份验证信息并再次登录，请使用pa auth logoutpa auth login，然后使用：
pa auth logout
pa auth login
升级数据
在联系技术支持提出问题之前，请提供：
- 来自
pa --version的 CLI 版本 - 操作系统和 Shell，例如 Windows 命令提示符、PowerShell 或 WSL
- 使用的完整命令
- 脱敏后的调试输出
-
power.config.json在您屏蔽敏感值后