Unity状态机PlayerController空引用错误(Object reference...)修复求助

错误原因分析 #

你的代码触发空引用错误，核心问题有3点：

1. 非生命周期阶段调用查找API：PlayerIdle类在字段声明时直接调用GameObject.Find，此时场景对象尚未完成初始化，返回null。
2. 未初始化的组件引用：CharacterController、cam等字段没有赋值，调用其方法时触发空引用。
3. 无效的序列化标签：[SerializeField]仅对继承自MonoBehaviour的类生效，PlayerIdle不属于此类，标签无效。

修复方案 #

1. 补充抽象基类PlayerState #

确保状态基类定义核心状态方法：

using UnityEngine;

public abstract class PlayerState
{
    protected PlayerController playerController;

    protected PlayerState(PlayerController controller)
    {
        playerController = controller;
    }

    public abstract void OnStateEnter();
    public abstract void OnStateUpdate();
    public abstract void OnStateExit();
}

2. 修改PlayerIdle类 #

将依赖获取逻辑移到OnStateEnter（状态进入生命周期），通过PlayerController关联所需对象：

using UnityEngine;

public class PlayerIdle : PlayerState
{
    private CharacterController controller;
    private Transform cam;
    private GameObject player;
    private Transform groundCheck;

    public float speed = 12f;
    public float gravity = -9.81f;
    public float jumpHeight = 3;
    public float rotationSpeed = 100f;

    private float x;
    private float z;
    public float groundDistance = 0.4f;
    public LayerMask groundMask;

    private Vector3 velocity;
    public bool isGrounded;

    public float turnSmoothTime = 1f;
    private float turnSmoothVelocity;

    public PlayerIdle(PlayerController playerController) : base(playerController)
    {
        this.playerController = playerController;
    }

    public override void OnStateEnter()
    {
        // 从PlayerController获取核心对象与组件
        player = playerController.gameObject;
        controller = player.GetComponent<CharacterController>();
        cam = Camera.main.transform;
        // 假设groundCheck是Player的子物体
        groundCheck = player.transform.Find("groundCheck");

        velocity = Vector3.zero;
    }

    public override void OnStateExit()
    {
        velocity = Vector3.zero;
    }

    public override void OnStateUpdate()
    {
        // 提前检查关键引用，避免空引用
        if (controller == null || groundCheck == null)
        {
            Debug.LogError("PlayerIdle缺少必要的组件或对象引用");
            return;
        }

        x = Input.GetAxisRaw("Horizontal");
        z = Input.GetAxis("Vertical");
        
        // 地面检测
        isGrounded = Physics.CheckSphere(groundCheck.position, groundDistance, groundMask);

        // 移动逻辑
        if (z != 0)
        {
            Vector3 moveDir = Quaternion.Euler(0, cam.eulerAngles.y, 0) * Vector3.forward;
            moveDir.Normalize();
            velocity = moveDir * speed * z;
        }
        else
        {
            velocity = new Vector3(0, velocity.y, 0);
        }

        // 跳跃逻辑
        if (Input.GetButtonDown("Jump") && isGrounded)
        {
            velocity.y = Mathf.Sqrt(jumpHeight * -2 * gravity);
        }

        // 重置地面重力
        if (isGrounded && velocity.y < 0)
        {
            velocity.y = -2f;
        }

        // 应用重力
        velocity.y += gravity * Time.deltaTime;

        // 旋转逻辑
        if (x != 0)
        {
            player.transform.Rotate(new Vector3(0f, x * rotationSpeed * Time.deltaTime, 0f));
        }

        // 执行移动
        controller.Move(velocity * Time.deltaTime);
    }
}

3. 验证PlayerController配置 #

确保挂载PlayerController的GameObject满足：

• 已添加CharacterController组件
• 存在名为groundCheck的子物体（用于地面检测）
• 场景中存在主相机（或指定相机）

关键修复要点 #

• 所有对象/组件引用的获取必须放在OnStateEnter中，确保场景对象已初始化
• 通过PlayerController间接获取依赖，避免直接调用GameObject.Find
• 对关键引用增加空值检查，提前拦截错误
• 移除非MonoBehaviour类中的[SerializeField]标签

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