Unity打包Android时onClick()函数构建丢失问题解决方案

这个现象不是构建流程"擦除"了按钮绑定，Editor/模拟器正常、Android真机失效的UI事件问题，90%以上都是两类原因：

• IL2CPP代码裁剪：Android打包默认开启IL2CPP后端，当托管代码裁剪等级为中/高时，没有被显式代码引用、仅通过序列化拖拽绑定的OnClick方法，会被判定为无用代码裁掉，序列化存储的绑定找不到对应方法指针，点击自然无响应。Editor、PC模拟器默认用Mono后端、裁剪等级极低，不会触发这个问题。
• 平台序列化校验差异：Android平台对资源、脚本的GUID映射校验比Editor严格，如果你用了AssetBundle/Addressable加载UI资源，或者切换过脚本程序集定义，很容易出现按钮绑定的目标对象/方法引用丢失，Editor下因为有缓存容错不会报错，真机上直接失效。

1. 优先解决代码裁剪问题（覆盖80%场景） #

这步操作完成后不需要修改任何现有按钮绑定，直接解决裁剪导致的失效：

• 先做定位测试：打一个Development Build包，这个模式会默认把托管代码裁剪等级降到最低，如果这个包按钮功能正常，就可以100%确定是代码裁剪导致的问题。
• 正式包如果不需要极致的包体积，可以直接在Project Settings > Player > Android > Other Settings里把Managed Stripping Level调整为Low。
• 如果必须用中/高裁剪等级减包体积，在Assets文件夹根目录新建link.xml文件，写入以下配置，告诉IL2CPP不要裁剪你存放UI逻辑的程序集：

<linker>
  <!-- 默认你的游戏业务脚本都在Assembly-CSharp里，如果你自定义了程序集，替换成对应名称即可 -->
  <assembly fullname="Assembly-CSharp" preserve="all"/>
  <!-- 如果用了TextMeshPro等第三方UI插件，可以按需添加对应程序集配置，例如
  <assembly fullname="Unity.TextMeshPro" preserve="all"/>
  -->
</linker>

• 对于不想全局保留整个程序集的情况，只需要给所有拖拽绑定的OnClick方法头部加[Preserve]特性，就能保证方法不会被误裁。

2. 全局自动修复引用丢失（适配所有场景，一次配置全项目生效） #

如果是资源引用映射失效导致的问题，不需要给每个按钮单独加绑定脚本，只需要写一个全局修复组件，挂到游戏启动时最先加载的永不销毁节点上即可，所有场景加载完成后会自动扫描修复所有按钮：

using UnityEngine;
using UnityEngine.UI;
using UnityEngine.SceneManagement;

public class GlobalButtonBindingFix : MonoBehaviour
{
    void Awake()
    {
        DontDestroyOnLoad(gameObject);
        SceneManager.sceneLoaded += FixAllButtonsInScene;
    }

    private void FixAllButtonsInScene(Scene loadedScene, LoadSceneMode loadMode)
    {
        // 抓取当前内存中所有按钮对象
        Button[] allButtons = FindObjectsOfType<Button>(true);
        foreach (Button btn in allButtons)
        {
            // 过滤掉不属于当前加载场景、未激活的资源对象
            if (btn.gameObject.scene != loadedScene) continue;
            // 强制重置OnClick事件容器，触发序列化绑定重新加载
            btn.onClick = new Button.ButtonClickedEvent();
        }
    }

    void OnDestroy()
    {
        SceneManager.sceneLoaded -= FixAllButtonsInScene;
    }
}

如果你用Addressable/AssetBundle动态加载UI预制体，只需要在预制体实例化完成后，加一行调用扫描当前实例下所有按钮执行相同修复逻辑即可，不需要逐个按钮配置。

3. 必查避坑项 #

• 不要把拖拽绑定的OnClick方法写在静态类、抽象类里，Android平台的序列化系统无法正确持有这类方法的引用。
• 如果开启了Strip Engine Code选项，检查确认UnityEngine.UI模块没有被误裁剪，历史版本出现过开这个选项后UI模块被裁导致所有按钮事件失效的bug。
• 不要给拖拽绑定的OnClick方法写重载，序列化绑定对重载方法的识别在高裁剪等级下很容易出错，建议不同功能的方法用不同命名。

内容的提问来源于stack exchange，提问作者O-0111