Unity Analytics编辑器正常，iOS/Android打包初始化报哈希异常

问题描述 #

Unity Analytics在编辑器内运行完全正常，但打包为iOS或Android版本时，初始化阶段触发严重错误，报错信息如下：

{severity:critical, message:DependencyTreeComponentHashException: 引发了类型为“Unity.Services.Core.Internal.DependencyTreeComponentHashException”的异常。
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.GetPackageTypeHashFor (System.Int32 componentTypeHash) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.SortTreeThrough (System.Collections.Generic.IEnumerable`1[T] dependencyTypeHashes) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.SortTreeThrough (System.Int32 packageTypeHash) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.SortRegisteredPackagesIntoTarget () (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeServicesAsync () (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeServicesAsync () (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeAsync (Unity.Services.Core.InitializationOptions options) (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeAsync (Unity.Services.Core.InitializationOptions options) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.UnityServices.InitializeAsync (Unity.Services.Core.InitializationOptions options) (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.UnityServices.InitializeAsync (Unity.Services.Core.InitializationOptions options) (at <00000000000000000000000000000000>:0)
Unity.Services.Analytics.AnalyticsEventHandler.Start () (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncVoidMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Analytics.AnalyticsEventHandler.Start () (at <00000000000000000000000000000000>:0)
重新引发为DependencyTreePackageHashException: 排序包[-767424672][Ua2CoreInitializeCallback]时，哈希为[-1271305056]的组件引发异常。
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.SortTreeThrough (System.Int32 packageTypeHash) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.DependencyTreeInitializeOrderSorter.SortRegisteredPackagesIntoTarget () (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeServicesAsync () (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeServicesAsync () (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeAsync (Unity.Services.Core.InitializationOptions options) (at <00000000000000000000000000000000>:0)
System.Runtime.CompilerServices.AsyncTaskMethodBuilder.Start[TStateMachine] (TStateMachine& stateMachine) (at <00000000000000000000000000000000>:0)
Unity.Services.Core.Internal.UnityServicesInternal.InitializeAsync

解决方案 #

• 统一Unity服务包版本：确保Unity Services Core、Unity Analytics及相关依赖包的版本完全一致，版本不兼容是引发哈希冲突的常见原因。可在Package Manager中逐一检查并更新到匹配版本。
• 清理项目缓存：删除项目根目录下的Library和Temp文件夹，重启Unity后重新导入所有资源与包，解决缓存文件损坏导致的哈希计算异常。
• 手动控制初始化流程：禁用Analytics的自动初始化，在代码中显式调用UnityServices.InitializeAsync()，并添加异常捕获逻辑，示例代码如下：

  using UnityEngine;
  using Unity.Services.Core;
  using Unity.Services.Analytics;
  using System.Threading.Tasks;
  
  public class AnalyticsInitializer : MonoBehaviour
  {
      async void Start()
      {
          try
          {
              var options = new InitializationOptions();
              await UnityServices.InitializeAsync(options);
              await AnalyticsService.Instance.CheckForRequiredConsents();
              // 后续Analytics逻辑
          }
          catch (System.Exception e)
          {
              Debug.LogError($"Analytics初始化失败: {e.Message}");
          }
      }
  }
  

• 移除冗余服务依赖：如果项目未使用其他Unity Services组件（如Remote Config、Cloud Save等），直接在Package Manager中删除相关包，减少依赖树复杂度，避免不必要的哈希冲突。
• 升级Unity编辑器：使用Unity官方推荐的稳定版编辑器（与服务包版本匹配），旧版编辑器可能存在与新服务包的兼容性问题。

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