Godot首帧调用Physics相关接口返回结果异常如何解决

Godot物理引擎独立于逻辑帧运行，所有物理状态计算（碰撞重叠检测、射线检测结果等）仅在_PhysicsProcess物理步进完成后才会更新。引擎首帧执行_Ready()、首次_Process()/_PhysicsProcess()时，物理世界尚未完成第一次步进计算，所有碰撞查询接口默认返回空结果，这是引擎执行顺序的固有设计，不是功能bug。

方案1：主动强制刷新物理空间状态（首帧初始化首选） #

在首帧执行物理查询前，调用对应物理服务器的接口强制完成一次状态同步，再执行查询逻辑即可拿到正确结果，该方案同时支持重叠检测、射线检测、形状投射等所有物理查询场景。
2D项目参考代码：

public override void _Ready()
{
    // 获取当前Area所在的物理空间
    var space = area.GetWorld2D().Space;
    // 激活物理空间并刷新所有待处理的查询
    PhysicsServer2D.SpaceSetActive(space, true);
    PhysicsServer2D.SpaceFlushQueries(space);

    // 3D项目替换为PhysicsServer3D对应接口即可
    // var space = area.GetWorld3D().Space;
    // PhysicsServer3D.SpaceSetActive(space, true);
    // PhysicsServer3D.SpaceFlushQueries(space);

    // 同步完成后再执行查询，首帧即可拿到正确结果
    var test = area.GetOverlappingAreas();
    GD.Print(test.Count);
}

首帧执行Raycast射线检测前，加上上述物理空间刷新代码，就能解决射线检测结果为空的问题。

方案2：延迟一个物理帧再执行查询 #

如果不需要严格在_Ready阶段拿到结果，可以等待首次物理帧执行完成后再运行查询逻辑，代码实现最简单。
参考代码：

public override async void _Ready()
{
    // 等待第一次物理帧步进完成
    await ToSignal(GetTree(), "physics_frame");
    var test = area.GetOverlappingAreas();
    GD.Print(test.Count);
}

该方案缺点是结果会晚一帧返回，不适合需要首帧立刻根据物理状态做渲染初始化的场景。

方案3：主动刷新Area组件的碰撞状态 #

仅针对Area的重叠查询场景，可以在调用GetOverlappingAreas/GetOverlappingBodies前主动刷新组件状态：

public override void _Ready()
{
    area.ForceUpdateTransform();
    // Godot 4.x提供该接口，3.x版本无此方法时请使用方案1
    area.UpdateOverlaps();
    
    var test = area.GetOverlappingAreas();
    GD.Print(test.Count);
}

该方案仅对Area自身的重叠查询生效，无法解决射线检测首帧结果异常的问题，通用性较差。

注意：不要在未做物理状态同步的前提下，在_Ready或首帧生命周期函数中依赖物理查询结果做初始化逻辑，否则所有类型的物理检测都会返回空值。

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