Godot 4场景切换异常：带参数显示空白，无参数无法触发

先解决信号参数报错的问题 #

Area2D的body_entered信号本身会传递一个参数（触发碰撞的物体节点），所以你的处理函数必须保留body参数，绝对不能改成() -> void:。哪怕你用不到这个参数，也得留着，否则就会出现你遇到的参数不匹配报错。恢复原函数签名即可：

func _on_house_one_door_body_entered(body):
    SceneSwitcher.switch_scene("res://scenes/house_one.tscn")

再解决场景切换后灰色空白的问题 #

灰色空白通常是场景切换逻辑有问题，或者新场景本身配置不对，按以下步骤排查：

1. 确保场景切换器是全局自动加载的 #

你直接用SceneSwitcher.switch_scene调用的是类名，但Godot里必须要实例化后才能调用方法。把场景切换脚本设置为自动加载：

• 打开「项目 -> 项目设置 -> 自动加载」
• 点击添加按钮，选择你的场景切换脚本（或者挂了这个脚本的空节点），把名称设为SceneSwitcher
• 这样全局才能通过SceneSwitcher访问到实例的方法，否则调用可能无效甚至导致异常。

2. 修正场景加载与释放逻辑 #

原代码里的场景释放和加载可以调整得更稳妥：

• 用queue_free()替代free()，让引擎在下一帧安全释放旧场景，避免资源残留
• 用preload()预加载场景，避免加载延迟导致的空白
  修改后的切换函数：

func _deferred_switch_scene(res_path):
    current_scene.queue_free()
    var s = preload(res_path)
    current_scene = s.instantiate()
    get_tree().root.add_child(current_scene)
    get_tree().current_scene = current_scene

3. 检查目标场景的配置 #

• 确认res://scenes/house_one.tscn路径完全正确，注意大小写（部分系统对路径大小写敏感）
• 检查目标场景里有没有Camera2D节点，并且Camera2D的「当前」选项是否勾选。如果没有Camera2D，Godot会显示灰色空白，因为没有相机来渲染场景内容。

4. 验证碰撞信号是否正确连接 #

虽然你说碰撞已被识别，但还是确认下：

• 门节点（Area2D）的body_entered信号是否正确连接到了你的处理函数_on_house_one_door_body_entered
• 玩家节点的CollisionShape2D是否正确设置了形状，并且「可检测」选项是勾选状态

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