2D脚本适配3D场景时出现空引用异常 GetGridPosition调用报错

你遇到的Object reference not set to an instance of an object是空引用报错，针对你怀疑的代码行Vector3Int gridPosition = tileMapReadcontroller.GetGridPosition(Input.mousePosition, mousePosition: true);，按以下优先级排查即可：

• 第一优先级：确认tileMapReadcontroller变量本身是否有有效引用
  2D项目中这个变量通常要么是在Inspector面板拖拽赋值，要么是代码自动查找场景中的2D Tilemap相关组件完成赋值。切换到3D场景后，如果对应脚本组件没有挂载到场景物体上、Inspector面板的引用拖拽丢失、或者自动赋值逻辑依赖的2D专属组件不存在，调用该对象的方法时会直接触发空引用。
• 第二优先级：检查GetGridPosition方法内部逻辑是否兼容3D场景
  2D环境下这个方法的常规实现是通过Camera.ScreenToWorldPoint转鼠标坐标，再调用Tilemap的WorldToCell拿到网格坐标，直接搬到3D环境很容易触发内部空引用：
  • 方法内部如果硬编码引用了2D Tilemap、2D Grid组件，3D场景下未保留对应组件时，拿到的引用为空，调用坐标转换方法就会报错
  • 2D正交相机下直接传鼠标坐标转世界坐标默认Z值为0，刚好匹配2D平面深度；3D透视相机下直接转出来的坐标是相机近裁剪面位置，和3D网格所在平面不匹配，后续逻辑如果没做有效性判断，也会触发空引用
• 快速定位技巧
  直接点击Unity Console面板里的报错条目，查看堆栈信息就能直接定位空对象：

  如果堆栈定位到你写的这行方法调用代码，就是tileMapReadcontroller本身没赋值，去检查变量的赋值链路，确认场景中存在对应组件、引用没有丢失
  如果堆栈跳转到GetGridPosition方法内部，逐行检查方法内用到的Camera、Grid、Tilemap这类和坐标转换相关的对象是否赋值成功

• 3D适配注意点
  3D场景下不要直接照搬2D的鼠标转网格逻辑，需要改成从鼠标位置发射物理射线，检测射线和网格所在平面（比如带碰撞体的地面）的命中点，再用命中点坐标转对应网格位置，否则就算解决空引用，拿到的坐标也是错误的。

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