HarmonyOS鸿蒙Next中在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。

HarmonyOS鸿蒙Next中在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。 【问题描述】：在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。

【问题现象】：在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。

cke_1074.png

【版本信息】：不涉及

【复现代码】：不涉及

【尝试解决方案】：暂无


更多关于HarmonyOS鸿蒙Next中在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。的实战教程也可以访问 https://www.itying.com/category-93-b0.html

5 回复

开发者您好

【解决方案】

发布应用链接时，AGC会去网站下载配置的 JSON 文件

JSON 文件地址：https://{域名}/.well-known/applinking.json，AGC 后台下载 JSON 文件的方法是 GET

  • 检查网关或者防火墙是否有相关限制。
  • 检查服务器网络问题。
  • 复制JSON配置链接后在浏览器中点击查看来确认是否可以直接查看，如果是文件位置放置错误，重新调整文件位置。
  • 浏览器可以正常访问到 JSON 文件，但还是提示下载 JSON 失败。可能是设置了重定向策略或者转发策略配置有误，请不要设置重定向策略。也可能是服务器对 ACG 后台发起的请求进行了拦截，请检查 CDN 等是否配置了拦截策略。
  • JSON文件中配置的AppID如果不在AGC配置的应用列表中，状态也会显示失败。

【背景知识】

App Linking：为开发者提供了统一的链接跳转能力，可以基于社交平台、应用链接等形态，满足对用户的拉新、促活等场景，后续还将规划应用短链等能力，支持链接跳转逻辑可配置，提供更加灵活的链接跳转能力。

常见问题参考：常见FAQ。

更多关于HarmonyOS鸿蒙Next中在AGC创建应用链接时，报错提示：下载源JSON文件失败，请确保源JSON文件已被授权访问。的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


我们的服务器拒绝了AGC的请求，通过就好了，

1、确保你的配置文件applinking.json是否放置在正确的目录（.well-known）下并且能够正常访问，可在浏览器中直接输入地址验证。

  • 例如： 通过浏览器等方式访问该json文件的地址：https://your.domain.name/.well-known/applinking.json，确保能正常访问。

2、如果1没问题，请检查json内的文件格式是否编写正确：

{
 "applinking": {
   "apps": [
     {
       "appIdentifier": "1234567"
     }
   ]
 }
}

其余AppLinking问题可前往官网FAQ进行查看： 【FAQ_AppLinking】

在AGC创建应用链接时出现“下载源JSON文件失败”错误，通常是因为JSON文件URL的访问权限问题。请按以下步骤排查：

  1. 确保JSON文件URL可通过公网直接访问，无登录等访问限制。
  2. 检查URL地址是否正确无误。
  3. 确认服务器未屏蔽AGC服务器的请求IP。
  4. 验证JSON文件格式是否符合规范。

完成上述检查并修正后，重新在AGC尝试创建应用链接。

这个错误通常是由于应用关联的JSON文件（例如 app.json 或 module.json）的访问权限问题导致的。请按以下步骤排查：

  1. 检查JSON文件路径与权限：确保在项目配置中指定的JSON文件路径正确，且该文件存在于对应的存储位置（如华为云存储）。如果文件在云端，请确认其访问权限已设置为公开可读，私有文件会导致AGC无法下载。

  2. 验证网络与域名：如果JSON文件托管在第三方服务器，请确保该域名未被防火墙拦截，且AGC服务能够正常访问该URL。可尝试通过浏览器直接访问JSON文件链接，确认能正常下载。

  3. 检查AGC控制台配置：在AGC创建应用链接时，需确保填写的“源JSON文件URL”准确无误，且链接可直接下载（例如以.json结尾的直链）。避免使用需要鉴权或重定向的链接。

  4. 更新HarmonyOS SDK/工具：若工具版本过旧，可能存在兼容性问题。建议将DevEco Studio及相关SDK更新至最新版本，再重新尝试操作。

  5. 重新上传JSON文件：如果文件存储在华为云OBS等服务中，可尝试重新上传JSON文件，并确保上传后刷新权限设置。

完成上述检查后，重新在AGC创建应用链接，问题通常可解决。

回到顶部