游戏客户端架构 / 系统课时
角色卡顿先查哪一层
角色卡顿先查哪一层
角色动作突然停一帧、跳回旧姿态,或人群场景出现周期性顿挫时,不要先调过渡时长。先固定复现场景并记录异常帧,再沿资源有效性、播放进度、过渡混合、骨骼写回和画面提交逐层检查,明确卡顿真正出现在哪一层。
学习目标
- 区分整帧耗时过长、播放进度停滞和姿态显示异常。
- 建立资源、时钟、状态、骨骼与渲染的分层证据链。
- 使用 Unity 的日志与 Profiler 验证定位结论。
先区分帧慢还是动作停
观察同一帧内的其他运动物体、UI 计时和角色世界坐标。若所有对象一起顿挫,优先查主线程、GC、资源加载或渲染耗时;若只有个别角色冻结,而镜头与其他角色平滑,优先查该角色的 Animator、动画剪辑及蒙皮路径。角色位置连续前进但腿部动作不变,也可能只是动画没有更新,而不是移动系统卡顿。
复现时固定角色数量、摄像机距离、动作和播放速度,并记下异常发生的帧号。只看平均 FPS 容易漏掉单帧尖峰,最好同时保留 CPU Timeline、渲染帧耗时与角色的播放进度。
按检查顺序锁定故障边界
下图是故障排查路径,不是引擎每帧内部的严格执行顺序。每通过一层,就确认“该层确实产生了下一层需要的有效数据”,不要在后续层替前一层猜原因。

| 检查层 | 要取得的证据 | 常见异常 |
|---|---|---|
| 资源与剪辑 | Controller 与 Clip 已绑定,剪辑有有效曲线 | 丢失 Motion、导入或骨骼映射不匹配 |
| 播放时钟 | 当前状态、normalizedTime、Animator.speed |
进度不前进,固定步进与渲染帧不同步 |
| 状态与混合 | 过渡标志、当前和下一片段权重 | 短时间反复切换、上层遮罩覆盖 |
| 骨骼与位移 | 骨骼 Transform、IK 与根运动结果 | 后执行的脚本覆写姿态 |
| 显示与性能 | SkinnedMeshRenderer、裁剪状态、Profiler 尖峰 | 可见性裁剪、蒙皮或渲染负载 |
用播放进度捕捉异常帧
以下示例面向 Unity,保存为 AnimationStutterProbe.cs 并挂在同一角色的 Animator 对象上。它在 LateUpdate 记录超过 50 毫秒的慢帧,以及同一状态连续两帧没有推进的可疑情况;日志只是线索,不能单独证明故障。
using UnityEngine;
[RequireComponent(typeof(Animator))]
public sealed class AnimationStutterProbe : MonoBehaviour
{
private Animator animator;
private int lastHash;
private float lastProgress;
private bool hasSample;
private void Awake() => animator = GetComponent<Animator>();
private void LateUpdate()
{
if (!animator.isActiveAndEnabled || animator.layerCount == 0) return;
AnimatorStateInfo state = animator.GetCurrentAnimatorStateInfo(0);
bool transitioning = animator.IsInTransition(0);
bool canAdvance = state.loop || state.normalizedTime < 0.99f;
// 排除状态切换、正常停在片尾和主动暂停的情况。
bool unchanged = hasSample && lastHash == state.fullPathHash
&& !transitioning && canAdvance && animator.speed > 0f
&& Time.deltaTime > 0f
&& Mathf.Abs(state.normalizedTime - lastProgress) < 0.0001f;
float frameMs = Time.unscaledDeltaTime * 1000f;
// 仅在可疑帧输出,减少日志自身造成的性能干扰。
if (unchanged || frameMs > 50f)
Debug.Log($"frame={Time.frameCount} ms={frameMs:F1} state={state.fullPathHash} phase={state.normalizedTime:F3} unchanged={unchanged}");
lastHash = state.fullPathHash;
lastProgress = state.normalizedTime;
hasSample = true;
}
}预期输出(例如某帧耗时 66.7 毫秒但动画进度仍在前进):
frame=<ID> ms=66.7 state=<ID> phase=0.375 unchanged=False其中帧号、状态哈希和进度均以实际运行值为准。unchanged=True 也可能来自固定步进更新模式、可见性裁剪或某个状态的时间缩放,不能直接认定剪辑损坏。需要对同一异常帧查看 Profiler,再进一步确认。
只修复有证据的一层
如果 normalizedTime 与相邻骨骼变换都停止,就检查更新模式、动画速度、时间缩放、可见性裁剪和资源有效性。如果播放进度连续,但姿态突然跳变,就重点检查切换条件、过渡打断、层权重和 IK 或脚本覆写。如果骨骼已经改变但屏幕仍冻结,则检查 SkinnedMeshRenderer、裁剪范围、相机可见性及渲染耗时。
每次只改动一个变量,使用相同动作和视角再次录制异常帧。验收必须同时看到播放进度连续、骨骼输出合理和帧耗时恢复;只消除日志而没有消除画面问题,不算定位完成。