Unity启用NavMeshAgent时nextPosition与destination异常偏移，重置操作无效

• 回合制游戏的单位状态切换逻辑：未被选中时作为普通NavMeshObject运行，被选中时启用NavMeshAgent组件；全程配置NavMeshAgent永久关闭updatePosition、updateRotation属性，仅依靠Agent计算导航路径，后续导航移动动作全部由自定义逻辑实现
• 异常触发流程：
  1. 启用NavMeshAgent前，提前检查Agent的nextPosition、destination属性，数值与游戏对象自身位置完全一致
  2. 执行agent.enabled = true启用组件后，两个属性会莫名沿Z轴方向偏移约2个单位
  3. 偏移发生后，尝试的修正操作——直接为nextPosition赋值、通过SetDestination设置同位置目的地、调用Warp方法对齐位置——均无法修正两个属性的数值，最终生成的导航路径起点位置错误
• 复现范围：Unity 2020.2.7f1及多个2020.x版本均稳定复现，无公开同类问题反馈

原始逻辑代码如下：

protected void SetCharacterNavAgentOn()
{
    obstacle.enabled = false; // 此时nextPosition与destination数值完全正确
    agent.enabled = true; // 启用后两个属性立即出现Z轴方向偏移
    agent.nextPosition = gameObject.GetComponent<Rigidbody>().position; // 赋值操作未生效
    agent.SetDestination(gameObject.GetComponent<Rigidbody>().position); // 目的地设置未生效
    bool isSuccessfull = agent.Warp(gameObject.GetComponent<Rigidbody>().position); // 虽然返回true，但位置修正未生效
    gameObject.GetComponent<BoxCollider>().enabled = false;
    gameObject.GetComponent<Rigidbody>().isKinematic = true;
}

该问题并非无规律的引擎随机Bug，是NavMeshAgent原生初始化规则与组件配置、执行顺序不匹配导致的固定问题：

1. 组件启用时的自动锚定逻辑：当agent.enabled被设为true的瞬间，Unity会自动将Agent的内部模拟位置，锚定到当前位置附近最近的NavMesh可行走表面点。观察到的Z轴2单位偏移，本质是这个自动锚定的落点，和预期的单位实体位置存在偏差。
2. 同帧操作失效的原因：NavMeshAgent的内部位置同步、NavMesh表面锚定计算，是在Unity的帧更新流程、物理模拟流程中执行的。在启用Agent后的同一帧立刻执行的所有属性修改操作，会被Agent当帧的内部初始化逻辑覆盖，操作实际作用在还没完成初始化的组件上，自然不会生效。
3. 偏差放大的关联因素：同帧切换的NavMeshObstacle、BoxCollider、Rigidbody属性，会触发物理引擎位移同步、NavMeshObstacle雕刻计算，进一步放大Agent自动锚定NavMesh点的偏差值。

• 跨帧拆分Agent初始化流程，避开同帧覆盖问题
  1. 第一帧先完成所有物理状态切换：关闭obstacle、关闭BoxCollider、将Rigidbody设为isKinematic = true，确保单位物理状态完全稳定，不会产生额外位移
  2. 执行agent.enabled = true开启组件，本帧不执行任何Agent属性修改操作
  3. 等待下一帧Agent完成内部NavMesh锚定计算后，再执行对齐操作：调用agent.Warp(单位当前实际位置)强制覆盖Agent内部模拟位置，再将agent.nextPosition手动赋值为单位实际位置
• 调整Agent基础配置，从根源降低锚定偏差
  • 将Agent的baseOffset值设为0，清除默认配置的垂直偏移量——这个值是Agent模拟位置和GameObject根位置的固定偏移，配合自动锚定逻辑很容易产生大数值位置偏差
  • 检查对应区域的NavMesh烘焙范围，确保单位站立的地面区域完全被NavMesh覆盖，没有可行走区与实体位置的缝隙，避免Agent找最近NavMesh点时出现落点偏移
• 可选快速修正方案
  如果不想拆分跨帧逻辑，可以在启用Agent前，提前将agent.nextPosition设置为单位的实际位置，再执行agent.enabled = true——Unity初始化Agent时会优先读取提前缓存的nextPosition值，不会触发重新自动锚定NavMesh点的逻辑
• 路径校验环节
  所有修正操作完成后，调用agent.CalculatePath(目标点, 路径存储变量)，校验返回路径的第一个节点坐标，确认和单位实际位置的偏差在0.01单位以内后，再正式启动导航逻辑。

内容的提问来源于stack exchange，提问作者Ben S