如何解决[FirebaseAnalytics][I-ACS023001] Deep Link必填参数缺失问题

针对你遇到的[FirebaseAnalytics][I-ACS023001] Deep Link does not contain valid required params错误，结合日志参数情况，可按以下步骤排查解决：

1. 确认动态链接核心必填参数 #

Firebase动态链接的核心必填参数是d（编码后的目标链接），从你的日志参数来看，当前链接缺少该参数。正常情况下，Firebase短链接（比如日志里_osl对应的https://helpwise.page.link/TJBU）跳转时会自动解析出d参数，若未出现，大概率是链接生成或解析环节出了问题。

2. 验证动态链接生成流程 #

• 控制台生成链接：如果是通过Firebase控制台创建的动态链接，检查是否完整填写了「目标链接」「关联应用」等必填项，生成后直接复制包含d参数的完整长链接测试跳转，排除短链接解析异常的可能。
• 代码生成链接：如果是通过SDK生成动态链接，确保代码逻辑正确，示例（以iOS为例）：

  let components = DynamicLinkComponents(
    link: URL(string: "https://app.helpwise.io")!,
    domainURIPrefix: "https://helpwise.page.link"
  )
  // 关联iOS应用
  let iOSParams = DynamicLinkIOSParameters(bundleID: "com.saaslabs.helpwise")
  iOSParams.appStoreID = "1503985272"
  components.iOSParameters = iOSParams
  // 关联Android应用
  let androidParams = DynamicLinkAndroidParameters(packageName: "com.saaslabs.helpwise")
  components.androidParameters = androidParams
  // 生成链接
  guard let dynamicLink = components.url else {
    // 处理生成失败逻辑
    return
  }
  

  确认生成的链接包含d参数。

3. 检查应用关联配置 #

• iOS端：确认apple-app-site-association文件配置正确，格式示例：

  {
    "applinks": {
      "apps": [],
      "details": [
        {
          "appID": "你的TeamID.com.saaslabs.helpwise",
          "paths": ["*"]
        }
      ]
    }
  }
  

  确保文件放置在域名的.well-known目录下，且无访问限制。
• Android端：确认assetlinks.json文件配置正确，格式示例：

  [
    {
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
        "namespace": "android_app",
        "package_name": "com.saaslabs.helpwise",
        "sha256_cert_fingerprints": ["你的SHA256指纹"]
      }
    }
  ]
  

4. 排查第三方或自定义逻辑干扰 #

检查是否有自定义的链接拦截、跳转逻辑，或者第三方SDK（如埋点、跳转工具）修改了动态链接参数，导致d等必填参数丢失或篡改。可暂时禁用这些逻辑，测试纯Firebase动态链接的跳转情况。

5. 更新Firebase SDK版本 #

确保项目中使用的Firebase Analytics和Dynamic Links SDK为最新稳定版本，旧版本可能存在参数解析的已知bug，更新后再测试问题是否消失。

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