Unity操控玩家Y轴位置实现无限楼梯时出现双位置异常

问题背景 #

开发攀爬无限楼梯游戏时，最初通过操控玩家Z轴位置实现的无限走廊原型运行正常，将逻辑改为操控玩家Y轴位置适配无限楼梯后出现异常：玩家表现为仿佛同时存在两个Y轴位置。
涉及两个核心脚本：

• HallWayController：负责无限空间的位置重定位
• PlayerController：挂载在玩家对象上，负责CharacterController移动、重力、跳跃逻辑

测试观测到的现象：

• 重定位逻辑写在FixedUpdate()中时：游戏视图内玩家位置无变化，但Debug.Log输出显示玩家Y坐标已改变；玩家抵达Y轴边界时，越界判断内的代码会无限循环执行。
• 重定位逻辑改到Update()中时：游戏视图和Debug.Log均能显示位置变化，但玩家会在原位置和重定位位置之间来回闪烁；玩家抵达Y轴边界时，边界判断内的代码同样会无限执行。

异常根本原因 #

1. CharacterController组件缓存与时序冲突 #

CharacterController组件不直接依赖Transform的position值计算移动，内部独立缓存了位置、速度状态。
之前Z轴无限走廊逻辑可正常运行，是因为Z轴无持续自动位移，仅响应玩家手动输入，修改Transform的时序冲突不明显。但Y轴方向上，CharacterController每固定帧都会施加重力、调用Move()方法修改位置：

• 两个脚本逻辑都放在FixedUpdate时，Unity不保证同生命周期脚本的执行顺序：如果HallWayController先修改玩家Y坐标，后续PlayerController调用controller.Move()时，组件会用内部缓存的旧位置覆盖手动修改的Transform值，就会出现日志坐标变化、视图玩家不动的现象。
• 重定位逻辑改到Update时，渲染帧和物理更新帧频率不匹配，手动修改位置和组件内部回写位置交替触发，就会出现两个位置来回切换的闪烁问题。

2. 重定位逻辑未形成闭环，触发死循环 #

• 重定位后没有重置玩家Y轴缓存速度：玩家被传回合法区间后，残留的向上/向下速度会立刻将玩家再次推到边界外，反复触发越界判断。
• 参数不匹配：如果HALLWAY_HEIGHT数值不等于上下Y轴边界的差值，重定位后的坐标可能依然落在越界区间，直接导致位置来回跳转的死循环。

修复方案 #

1. 调整重定位逻辑的执行时机 #

将重定位逻辑从FixedUpdate/Update移到LateUpdate生命周期，该生命周期在所有Update、FixedUpdate的移动逻辑执行完毕后才运行，不会被之前的移动逻辑覆盖修改结果。

2. 重定位时同步清空组件缓存、重置速度 #

修改Transform位置后，通过禁用再启用CharacterController的方式清空组件内部的位置缓存；同时开放方法重置PlayerController中缓存的Y轴速度，避免残留速度将玩家立刻推回边界。

3. 校准参数、优化重定位计算 #

保证MAX_Y_BOUND - MIN_Y_BOUND == HALLWAY_HEIGHT，重定位时直接对齐坐标，确保重定位后玩家一定处于合法Y轴区间，不会出现二次越界。 #

修正后代码示例 #

修改后的HallWayController #

public class HallWayController : MonoBehaviour
{
    [SerializeField] private float HALLWAY_HEIGHT = 20f;
    [SerializeField] private float MAX_Y_BOUND = 20f;
    [SerializeField] private float MIN_Y_BOUND = 0f;
    // 直接拖拽赋值玩家相关引用，不要仅缓存Transform
    [SerializeField] private PlayerController playerController;
    [SerializeField] private CharacterController playerCharController;
    private Transform player;

    void Start()
    {
        player = playerController.transform;
    }

    // 逻辑移到LateUpdate执行
    void LateUpdate()
    {
        HandleInfiniteStaircase();
    }

    private void HandleInfiniteStaircase()
    {
        if (IsPlayerOutOfBounds())
        {
            float targetY = player.position.y;
            if (player.position.y > MAX_Y_BOUND)
            {
                targetY -= HALLWAY_HEIGHT;
            }
            else if (player.position.y < MIN_Y_BOUND)
            {
                targetY += HALLWAY_HEIGHT;
            }

            // 重置CharacterController内部缓存
            playerCharController.enabled = false;
            player.position = new Vector3(player.position.x, targetY, player.position.z);
            playerCharController.enabled = true;

            // 重置玩家Y轴速度，消除残留位移
            playerController.ResetVerticalVelocity();
            
            Debug.Log("Player repositioned to Y: " + player.position.y);
        }
    }

    private bool IsPlayerOutOfBounds()
    {
        return player.position.y > MAX_Y_BOUND || player.position.y < MIN_Y_BOUND;
    }
}

修改后的PlayerController（新增公共方法） #

// 新增公共方法，供HallWayController调用重置垂直速度
public void ResetVerticalVelocity()
{
    playerVelocity.y = 0f;
}

其余原有PlayerController逻辑不需要改动。

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