Godot 4敌人导航路径丢失、抽搐折返问题排查求助

问题现象 #

在Godot 4开发中，敌人跟随玩家时会短暂切换路径至场景角落，出现抽搐、折返的异常行为，无法保持平滑的跟随路径。

实现代码 #

extends CharacterBody2D
class_name Ghosts

@onready var region_id: RID = NavigationServer2D.region_create()

var path:Array = []
var nav:NavigationRegion2D = null
var player = null

func _ready():
    await get_tree()
    var tree = get_tree()
    if tree.has_group("LevelNavigation"):
        nav = tree.get_nodes_in_group("LevelNavigation")[0]
        NavigationServer2D.region_set_map(region_id, get_world_2d().navigation_map)
        NavigationServer2D.region_ser_navpoly(region_id, nav.navpoly)  # 拼写错误
    if tree.has_group("Player"):
        player = tree.get_nodes_in_group("Player")[0]

func attack(speed:int):
    if path.size() > 0:
        velocity = global_position.direction_to(path[1]) * speed
        if global_position == path[0]:  # 精度问题导致无法触发
            path.pop_front()
    move_and_slide()

func generate_path(line2D: Line2D):
    if nav != null and player != null:
        path = NavigationServer2D.map_get_path(get_world_2d().navigation_map, position  # 代码不完整，缺少目标参数
        line2D.points = path

异常路径表现 #

截图中可见，敌人的导航路径突然偏离玩家方向，拐向场景角落，出现不必要的折返节点，导致敌人运动抽搐。

问题根源分析 #

1. 代码拼写错误：NavigationServer2D.region_ser_navpoly应为region_set_navpoly，错误调用会导致导航区域未正确注册，使用无效导航数据。
2. 路径生成代码不完整：map_get_path调用缺少玩家全局位置的目标参数，且语句未闭合，导致生成的路径无效或错误。
3. 位置判断精度问题：用global_position == path[0]判断到达节点，受浮点坐标精度限制几乎无法触发节点弹出，引发路径堆积、逻辑冲突。
4. 路径重算过于频繁：若每一帧都调用generate_path，玩家位置的微小变化会引发路径频繁更新，导致路径抖动。
5. 冗余导航区域创建：手动创建region_id并注册导航区域属于冗余操作，会与已有NavigationRegion2D节点产生冲突，干扰正确导航数据。

解决方案建议 #

• 修正拼写错误：将region_ser_navpoly改为region_set_navpoly。
• 补全路径生成逻辑：

  func generate_path(line2D: Line2D):
      if nav != null and player != null:
          path = NavigationServer2D.map_get_path(
              get_world_2d().navigation_map,
              global_position,
              player.global_position,
              true  # 启用路径优化，减少不必要节点
          )
          line2D.points = path
  

• 替换位置判断逻辑：用距离阈值代替精确相等判断：

  func attack(speed:int):
      if path.size() > 0:
          velocity = global_position.direction_to(path[0]) * speed  # 修正目标节点为path[0]而非path[1]
          if global_position.distance_to(path[0]) < 4.0:  # 4像素阈值，可根据场景缩放调整
              path.pop_front()
      move_and_slide()
  

• 限制路径重算频率：添加定时器，每0.2-0.5秒调用一次generate_path，或仅在玩家位置变化超过一定距离时才重算路径，避免频繁更新。
• 移除冗余导航区域代码：删除region_id变量及_ready中相关注册代码，直接依赖LevelNavigation组中NavigationRegion2D节点的导航数据。
• 检查导航多边形合法性：确保NavigationRegion2D的navpoly已正确烘焙，无重叠、缺口或无效区域，Godot 4对导航多边形合法性要求更严格。

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