Unity内置IK系统对自定义角色完全失效，求助排查解决

用户已完成配置 #

• 正确配置Humanoid Avatar
• Animator对应Layer已启用IK Pass
• 编写了调用OnAnimatorIK()的头部IK控制脚本
• 使用Blend Tree实现动画播放

用户已尝试操作 #

• 调整Blend Tree内动画的Mask

当前使用的IK代码 #

[SerializeField]
protected Animator animator;
public Transform lookObj;
void OnAnimatorIK()
{
   animator.SetLookAtWeight(1);
   animator.SetLookAtPosition(lookObj.position);
}

排查与解决要点 #

1. 验证脚本与Animator引用
   确认脚本挂载在带Animator组件的角色对象上，且animator字段已正确赋值（空引用会直接导致IK逻辑不执行）。可以在OnAnimatorIK()里加一行Debug.Log("IK方法执行")，运行时查看控制台是否有输出——没输出说明IK Pass未生效，或Layer配置错误。

2. 确认IK Pass的Layer匹配
   IK Pass是针对单个Layer生效的，必须保证播放Blend Tree动画的那个Layer开启了IK Pass。如果动画在Additive Layer播放，但仅在Base Layer开启IK Pass，IK完全不会起作用。

3. 检查动画Mask的头部权限
   调整Mask时，必须保证头部（Head）的权重设为100%。如果Mask限制了头部的动画控制权，IK无法覆盖原有动画的头部姿态，自然看不到效果。

4. 确认LookAt目标的有效性
   检查lookObj是否为空，且位置在角色正常视线范围内（别在角色身后或穿模进身体）。可以临时把lookObj换成场景中可见的空物体，拖到角色正前方测试。

5. 细化LookAtWeight参数
   直接设整体权重为1可能因动画优先级问题无效果，试试拆分参数调试：

   animator.SetLookAtWeight(1f, // 整体权重
                            1f, // 头部权重
                            0.5f, // 身体权重
                            0f, // 眼睛权重
                            0f); // 旋转限制权重，防止过度偏转
   

   逐步调整各参数，观察是否有变化。

6. 排查Root Motion影响
   如果角色开启了Root Motion，部分动画的根运动可能干扰IK效果。可以暂时关闭Animator的Root Motion选项，测试IK是否恢复正常。

7. 重新校验Avatar映射
   即使显示Avatar配置正确，也要再检查Humanoid骨骼映射：Head、Neck必须对应角色模型的正确骨骼节点，骨骼映射错误会导致IK无法驱动头部运动。

内容的提问来源于stack exchange，提问作者Mission Zero