Unity寻路报错“SetDestination“ can only be called on an active agent that has been placed on a NavMesh.

这个报错表示NavMeshAgent所在节点未放置在寻路网格上。出现这个错误一般伴有

"Failed to create agent because it is not close enough to the NavMesh"类似警告。

表明寻路代理创建失败，后续设置目的地肯定就会导致失败。

出现此类问题需要检查：

1. 在调用SetDestination的时候，NavMeshAgent是否启用
2. NavMeshSurface是否存在

如果所有都设置正确，但是还是报这个错误。恭喜你，跟我遇到了相同的问题~

这个报错我在Editor与测试APK总都没有遇到过（如果遇到肯定早想办法解决了~），等项目上线了，发现bugly上报非常多这个报错。让我非常费解，幸运的是我找了NavMeshAgent的源码，才找到了一个稍微安全一点避免错误的方式。

Agent寻路中一个比较重要的功能是避障功能，Unity采用了一个叫群组绕行管理器（Detour Crowd Manager）来管理Agent。当我们可以调用SetDestination的前提就是我们的Agent被添加到了这个绕行管理器中。以下有几种方式会触发添加行为：

1. NavMeshSurface变更，比如的Obstacle挖孔就会触发这个行为
2. NavMeshAgent::OnEnable的时候会尝试去添加
3. 调用NavMeshAgent::Warp会去添加

第一种触发行为需要修改寻路网格，第二种是由系统调用，最后这个可以由我们自己主动触发。

这里你可以检查一下你设置你Agent所在transform是直接使用transform.position吗？

如果是，那就好办，将transform.position来修改坐标的方式替代为使用agent.Warp来修改。

 这样，在添加进绕路系统的同时，也会修改transform的坐标。

至于为什么会出现这种情况，我猜想是首次添加Detour Crowd的时候没有成功，失败的原因也很多，因为无法去debug，只能有这种猜想。后续由于没有再次触发这种添加行为导致的出错。不过至少，直接使用Warp设置坐标，可以保证不出错误。