Unity 3D：Animation手动播放正常但Animator播放时不生效

问题现象 #

Animator组件状态机显示动画处于正常播放进度，但对应GameObject的位移、旋转、骨骼动画均无变化；在动画编辑窗口手动拖动时间轴预览动画时，效果可正常显示。
相关运行时状态截图：

动画资源导入配置截图：

核心原因 #

该问题本质是动画求值后的属性写入链路被阻断，动画剪辑本身的轨道配置无异常（手动预览生效可直接排除动画资源损坏问题），按以下优先级从高到低排查即可：

排查与解决步骤 #

第一优先级（覆盖90%以上同类问题） #

• Culling Mode配置错误
  打开动画资源导入配置的Animation页签，检查Culling Mode选项：如果当前设置为Based On Renderers，当动画目标物体的SkinnedMeshRenderer/Renderer组件被禁用、物体完全处于相机视锥外、或者Renderer和Animator不在同一激活的GameObject层级下时，引擎会跳过动画属性求值，哪怕状态机进度条正常走也不会写入任何属性修改。测试阶段直接将该选项改为Always Animate即可快速验证是否是该问题，上线前再根据性能需求调整回合理配置。
• Avatar引用不匹配/丢失
  选中挂载Animator的GameObject，检查Inspector面板Animator组件的Avatar字段：Humanoid类型动画必须绑定和当前模型骨骼完全匹配的Avatar，Generic类型动画要确认动画轨道记录的Transform层级路径和当前物体的子节点层级完全一致。最常见的触发场景是替换模型预制体后未更新Animator的Avatar引用，或是动画导入时绑定了其他模型的Avatar。
• 动画输出属性被其他逻辑覆盖
  Unity引擎中属性写入的优先级从低到高为：动画系统求值 < Update生命周期脚本赋值 < 物理引擎FixedUpdate赋值 < 约束组件（Parent Constraint/Position Constraint等） < LateUpdate生命周期脚本赋值。如果动画修改的Transform、骨骼旋转等属性，被挂载的角色控制器、NavMeshAgent、自动布局组件、自定义脚本每帧强制赋值，动画的修改会被直接覆盖。手动预览动画时不会触发运行时的脚本、物理、约束逻辑，因此预览正常，运行时失效。
• Animator层配置错误
  打开对应的Animator Controller，检查播放动画的层权重（Weight）是否为0，或是绑定的Avatar Mask排除了所有需要动画驱动的骨骼/节点。层权重为0时状态机仍会正常切换状态、推进播放进度，但不会输出任何属性修改。

第二优先级（剩余10%场景） #

• Root Motion配置冲突
  如果动画开启了根运动，检查Animator组件的Apply Root Motion选项是否和逻辑匹配：如果勾选了该选项但物体上挂载了直接修改Transform的移动逻辑，或是挂了Rigidbody/NavMeshAgent等会接管物体移动的组件，会导致根运动输出的位移被直接覆盖。
• 运行时Controller被动态替换
  运行时选中Hierarchy面板中的目标物体，查看Inspector中Animator组件的Controller字段，确认没有被代码动态替换为其他无有效动画的状态机；同时检查当前播放状态的Speed参数是否被设为0、Motion字段是否被动态置空——状态卡在无Motion的状态时，进度条仍会推进但无实际动画输出。
• Update Mode配置不匹配
  如果Animator的Update Mode设置为Animate Physics，检查物体上挂载的Rigidbody组件是否开启了Kinematic、插值配置是否正确，该模式下动画会在物理帧更新，配置错误会导致动画更新和渲染不同步，视觉上表现为动画不生效。

快速定位技巧 #

1. 新建空场景，仅保留目标物体的Animator、模型渲染组件，移除所有第三方脚本、约束、导航、物理组件后运行，如果动画正常生效，说明是其他组件逻辑覆盖了动画输出，逐个加回组件即可定位冲突源。
2. 给物体挂载测试脚本，在LateUpdate生命周期打印动画驱动的目标属性值，如果打印值和动画预期值一致但物体显示异常，说明属性是在动画求值完成后被其他逻辑覆盖的。

注意：调用animator.Play()的同一帧不会立刻触发动画求值，此时读取到的属性值还是修改前的旧值，属于引擎正常逻辑，不属于异常。

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