Unity 合并资源后 Prefab 脚本 Missing 的问题排查现象常规按钮点击卡死无响应，日志持续刷脚本缺失告

一个"脚本丢失"问题的完整排查实录：从现象、误入热更歧途、到最终定位到 meta 文件 GUID 引用断裂的真因。附 meta 机制讲解与修复路径清单。

现象

常规按钮点击卡死无响应，日志持续刷脚本缺失告警，随后触发空引用崩溃：

W  The referenced script on this Behaviour (Game Object '') is missing!
W  The referenced script on this Behaviour (Game Object '<null>') is missing!
    UnityEngine.Object:Instantiate(Object, Transform, Boolean)
    UnityEngine.Object:Instantiate(T, Transform, Boolean)
    NGUITools:AddChild(GameObject, GameObject, Int32)
    Oak.UI.<LoadUIAsset>d__60:MoveNext()
    Foundations.Coroutine:MoveNext()
    Foundations.Coroutine:Restart()
    Foundations.CoroutineManager:Update()

W  The referenced script on this Behaviour (Game Object 'xxxMoveUI') is missing!
    UnityEngine.Object:Instantiate(Object, Transform, Boolean)
    UnityEngine.Object:Instantiate(T, Transform, Boolean)

NullReferenceException: Object reference not set to an instance of an object.
    at Oak.UI.UISceneManager+<OverlayPushTransition>d__66.MoveNext () [0x00000] in <00000000000000000000000000000000>:0
    at Foundations.Coroutine.MoveNext () [0x00000] in <00000000000000000000000000000>:0
    at Foundations.Coroutine.Restart () [0x00000] in <00000000000000000000000000000>:0
    at Foundations.CoroutineManager.Update () [0x00000] in <00000000000000000000000000000>:0
    Foundations.Coroutine:Restart()

guid差异

日志解读要点：UI 在 Instantiate（实例化预制体）时发现引用的脚本丢失，该脚本组件被 Unity 丢弃（对象只剩一个无脚本的空壳），后续代码拿不到组件引用 → 空引用崩溃。日志本身不会告诉你"哪个脚本"丢了，需要靠现场排查定位。

排查过程

根据日志确认是预制体上的 MonoBehaviour 脚本丢失，在编辑器里把脚本重新拖到组件上，Unity 内直接查看已修复。
但出 AB 之后依然报脚本 missing。此时一度认为是"新增脚本不支持热更"，方向开始跑偏。
尝试几种代码热更新"增类"的方案都不太可行，尤其是新增类时提示"当前类已存在"——说明脚本本身在工程里是完好的，问题根本不在热更，这时隐约察觉进入了误区。
换一台环境一致的机器重新把脚本拖入预制体后再次打资源，问题成功修复。

根因

对比修复前后的预制体，发现：修复后的预制体旁新生成了脚本的 meta 文件，且其 guid 与预制体里序列化引用一致；而失败那次"新增的脚本"meta 文件 guid 与预制体的引用对不上——这正是脚本 missing 的真因。

背景：这个预制体是原生资源内新增的，脚本及其 meta 文件并没有随资源一起从原生侧上传过来。本地合并时 Unity 自动为脚本生成了新 meta（guid 随机），本地自动生成的 guid 与预制体里记录的引用不一致，导致引用断裂。 meta

补充：meta 文件与 GUID 机制

Unity 里每个资源（脚本、预制体、贴图等）都有一个同名 .meta 文件，其中存放该资源的 GUID（全局唯一标识符）。脚本引用、预制体内嵌对象、序列化字段全部靠 GUID 关联，不是靠文件名或路径。所以：

同名同路径的脚本，只要 meta 的 guid 不同，在 Unity 眼里就是两个不同的脚本。
预制体记录的是"引用那个 guid 的脚本"。本地新生成的 meta 如果 guid 对不上，编辑器自然显示 missing。
Assets/ 下没有 meta 时 Unity 启动会自动生成一个（guid 随机）。合并协作时meta 文件必须随资源一起提交，否则一旦本地重新生成，所有引用它的资源全部断裂——这是"为什么换环境一致的机器就能修好"的根本原因：meta 是新生成的，必须保持与引用一致。

修复

换一台环境一致（Unity Android/iOS Platform）的设备，重新把脚本拖入预制体，自动生成匹配的 meta 文件后重新打资源。

脚本 missing 的判断方法

遇到 "The referenced script ... is missing!" 时，先用下面两步确认"丢的到底是什么"，再决定修复路径：

编辑器内对照：选中报 missing 的 GameObject，在 Inspector 里看组件上的脚本槽。若脚本槽灰显/显示 Missing (Mono Script)，说明该引用找不到脚本。
GUID 定位：在 .unity / prefab 序列化文本中搜索报错对象的 m_Script: {fileID: ..., guid: ..., type: 3}，用拿到的 guid 去工程里全局搜这个 guid 对应的 .meta。找不到 → 脚本真没了；能找到但路径/内容可疑 → 再往下查是不是换了脚本但没换 meta（本案例即属此类）。

GUID 不匹配的修复路径清单

按优先级排列，任选其一即可：

优先级	方法	适用场景
1	换环境一致的机器重生成 meta	预制体是原生新增、meta 丢失时最稳（本案例采用）
2	找原生侧要正确 meta 文件，替换后上传 git	能拿到原文件时最精确，能保留原生侧全部引用
3	在编辑器中重新拖入脚本，让 Unity 自动重建引用	修改量小，但会丢失原有序列化引用（慎用）
4	用文本工具全局替换 guid 为新生成的 meta guid	仅适合少量引用、且能确认旧引用指向同一脚本

验证

换机器重新拖入脚本 + 打资源后，脚本 missing 问题消失

边界与启示

只处理"原生新增预制体"这类情况：若是常规合并（双方都已提交 meta），一般不会出现 missing，不必套用本方案的 meta 处理。
meta 丢失的另一半风险：除了脚本引用断裂，还要检查反向——脚本缺失不会让别的资源断裂，但如果丢的是资源（贴图、预制体）的 meta，引用它的对象反而会出问题。合并资源时把脚本/资源的 meta 一并纳入检查。
不要一上来就怀疑热更：missing 的成因里，"新增类不支持热更"只是少数，多数是 guid 引用断裂。先看 meta 再谈热更，避免走弯路（本案例第 2、3 步就差点被带偏）。

教训

合并资源时，对原生资源内新增预制体这种特殊情况要检查脚本 meta 文件是否随资源一并上传。
一旦发现 missing 情况：比对 guid，换一台环境一致的设备自动生成 meta 文件。
遇到脚本 missing，先查 meta/guid 再怀疑热更，避免排查方向跑偏。