为什么你写的RPC总是“丢包”?
做多人联机,RPC(Remote Procedure Call,远程过程调用)是绕不开的坎。你以为在客户端喊一嗓子Server_Attack(),服务器就会乖乖执行?现实往往是一顿操作猛如虎,同步一看原地杵。我带过太多学员,功能单机跑得飞起,一联机就各种幽灵动作、伤害不结算、表现不同步。今天不聊虚的,就扒一扒UE5网络RPC从入门到入土最常见的7个坑,每个坑都带着血泪教训,看完能帮你省下至少两周的调试时间。
坑1:在客户端调用Server RPC,却忘了加“Server”前缀
现象
你在角色蓝图里写了个自定义事件FireWeapon,勾选了“在服务器上调用”,满心欢喜地在客户端按键触发。结果服务器毫无反应,客户端本地特效倒是播得挺欢,但伤害数字一个没有。
根因
UE5的RPC识别完全依赖命名约定:Server_前缀的函数默认在服务器执行(客户端调用时通过远程调用发往服务器),Client_前缀在拥有该Actor的客户端执行,Multicast_则广播到所有客户端。你的事件叫FireWeapon,没前缀,引擎就把它当成普通函数——本地调用,本地执行,网络层根本不搭理你。
解决方案
重命名为Server_FireWeapon,并在函数细节面板勾选“可靠”(Reliable)或“不可靠”(Unreliable)。注意:只有Actor的Owner(拥有者)才能调用Server RPC。如果你的武器Actor没有设置Owner,调用会直接被丢弃。
预防措施
命名即契约。团队里强制约定:所有RPC函数必须带前缀,并在函数上方加注释标明调用方。蓝图里可以用“Switch Has Authority”节点做快速自检,但别依赖它代替正确命名。
坑2:NetMulticast的“本地预测”幻觉——你以为广播了,其实只跑了一次
现象
你写了个Multicast_PlayEffect来播放开枪特效,发现服务器上特效播放了,客户端上也播放了,但客户端本地玩家感觉有延迟,而且特效偶尔重复播放。
根因
NetMulticast的本质是:在服务器调用时,会广播到所有客户端(包括服务器自己);但如果你在客户端调用Multicast,它只会在本地执行一次,不会发到服务器,更不会广播。很多人在客户端直接调Multicast做“预测”,结果就是本地播了,别人看不到。另外,如果服务器调用Multicast,而该Actor在客户端还没同步生成(比如刚Spawn的Actor),广播会丢失。
解决方案
需要所有端表现一致的效果,务必在服务器端调用Multicast。如果要做本地预测(比如开枪瞬间本地先播特效),应该单独写一个普通函数在客户端本地调用,再通过Server RPC通知服务器,服务器再Multicast给其他客户端。注意用IsLocallyControlled区分本地玩家,避免重复播放。
预防措施
Multicast不是“万能广播”,它只保证从服务器发出。客户端调用Multicast = 自娱自乐。在蓝图里可以加一个“Switch Has Authority”判断,确保Multicast只在服务器端触发。
下面是一个标准的“本地预测+服务器广播”节点结构示例(蓝图伪代码):
// 客户端输入事件
InputAction Fire →
If IsLocallyControlled:
PlayLocalEffect() // 本地立即播放
Server_Fire() // 通知服务器
// Server_Fire (Reliable)
Server_Fire:
Multicast_PlayEffect() // 广播给所有客户端
ApplyDamage() // 服务器逻辑
坑3:Reliable RPC滥用导致带宽爆炸与卡顿
现象
游戏里每帧都在调用Server_UpdateAim(可靠RPC),玩家多了之后服务器CPU飙升,客户端出现明显延迟,甚至掉线。
根因
可靠RPC(Reliable)通过TCP-like的重传机制保证到达,但每个可靠RPC都会占用序列号、确认和重传队列。高频调用(比如每帧)会让网络缓冲区堆积,触发带宽限制(默认每个连接每秒约10KB的可靠流量),超限后引擎会断开连接。而且可靠RPC是阻塞式的,会拖慢后续RPC的发送。
解决方案
高频同步数据(如朝向、位置)改用属性复制(Replication)或不可靠RPC(Unreliable)。不可靠RPC不保证到达,但开销极低,适合每帧的视觉更新。对于必须可靠的关键事件(如开火、拾取),才用Reliable。
预防措施
记住一个数字:Reliable RPC的频率不要超过每秒10次。超过这个量级,就该考虑用属性复制或Unreliable RPC。在项目设置里可以调整
MaxReliableBandwidthPerConnection,但别指望调大就能解决问题——治标不治本。
坑4:在Actor的BeginPlay里调用RPC,结果服务器没收到
现象
你在玩家角色的BeginPlay里调用Server_InitHealth,想初始化生命值,结果服务器上打印日志显示根本没执行。
根因
RPC的调用权限取决于Actor的Owner和Role。在客户端,只有当Actor的Role是ROLE_AutonomousProxy(本地控制的角色)时,才能调用Server RPC。而BeginPlay在客户端可能比服务器端的网络连接建立更早,此时Actor的Owner可能还没设置,或者Role还是ROLE_SimulatedProxy,导致RPC被丢弃。
解决方案
把初始化逻辑放在PossessedBy或OnRep_PlayerState之后,确保网络角色就绪。更稳妥的做法是:在服务器端的BeginPlay里直接初始化(服务器本来就有权限),客户端通过属性复制获取初始值,而不是用RPC。
预防措施
RPC不是初始化工具。任何“设置初始状态”的需求,优先考虑属性复制(Replication)而不是RPC。属性复制会在Actor同步时自动把服务器值推给客户端,省心又可靠。
坑5:NetMulticast里的“可靠”勾选,导致广播风暴
现象
你给一个高频的Multicast(比如每0.5秒一次的脚步声)勾选了Reliable,结果玩家一多,服务器带宽直接爆表,玩家开始瞬移。
根因
Multicast + Reliable = 服务器向每个客户端发送可靠数据包。假设10个玩家,每次Multicast要发10份可靠包,每份都要确认和重传。如果频率高,可靠队列迅速填满,触发网络饱和,引擎会丢弃后续RPC甚至断开连接。
解决方案
Multicast默认应该用Unreliable。只有极少数必须保证到达的广播(比如游戏结束、回合开始)才用Reliable,并且频率要极低。对于持续的表现(特效、音效),Unreliable完全够用——丢一帧特效玩家根本感知不到。
预防措施
在蓝图里创建Multicast时,默认就是Unreliable。除非你明确知道“这个广播丢了会导致游戏逻辑错误”,否则不要勾Reliable。一个简单的判断标准:如果这个广播丢了,玩家会不会输?不会,那就Unreliable。
坑6:RPC参数包含Actor引用,但客户端还没同步该Actor
现象
服务器调用Client_ShowDamage(InstigatorActor, Damage),客户端收到RPC后,试图访问InstigatorActor的某个属性,结果报空指针。
根因
RPC参数中的Actor引用是通过网络对象引用(NetGUID)传递的。如果客户端还没有同步生成该Actor(比如它是在服务器上刚Spawn的,且相关Actor的NetCullDistance或OnlyRelevantToOwner设置导致客户端收不到),那么参数会变成nullptr。此外,如果Actor被销毁,引用也会失效。
解决方案
在RPC处理函数里做空值检查:if (!InstigatorActor) return;。如果确实需要该Actor,确保它的网络相关性(Relevancy)设置正确,或者改用其他标识符(如PlayerState、Actor的唯一ID)来传递,然后在客户端查找。
预防措施
永远不要假设RPC参数里的Actor在客户端一定有效。养成习惯:收到RPC后第一件事就是检查关键引用是否为空。另外,对于非拥有者客户端,Server RPC里传的Actor引用可能因为相关性被剔除而变成null。
坑7:在客户端调用Client RPC,结果只有自己执行了
现象
你写了个Client_ShowMessage,想在客户端弹个提示,结果在客户端直接调用,本地弹了,但其他玩家没弹。你以为是广播,其实不是。
根因
Client RPC只能在服务器上调用,且目标是一个特定的客户端(通常是Actor的Owner)。如果在客户端调用Client RPC,它只会在本地执行一次,不会发到服务器,更不会转发给其他客户端。它的设计用途是:服务器通知某个特定客户端“你该做什么”,比如更新UI、播放只有该玩家能看到的特效。
解决方案
如果想让所有客户端都看到,应该用Multicast。如果只想让某个玩家看到,在服务器上调用Client_ShowMessage,并确保该Actor的Owner是这个玩家。在客户端调用Client RPC是无效的。
预防措施
记住角色分工:Server RPC = 客户端请求服务器做事;Client RPC = 服务器通知特定客户端做事;Multicast = 服务器通知所有客户端做事。客户端自己调用Client RPC,就像对着镜子说话——只有自己听得见。
总结:RPC不是银弹,属性复制才是基石
上面7个坑,每一个我都亲眼见过学员踩进去,有的卡了一周才发现是命名问题。RPC很强大,但它只适合“事件驱动”的逻辑:开火、使用道具、触发动画。对于持续的状态同步(生命值、位置、弹药数),属性复制(Replication)才是正道。两者配合,才能写出既流畅又稳定的联机游戏。
如果你想系统掌握UE5网络同步、RPC、属性复制以及性能优化,光靠零散文章是不够的。在火星人教育,我们把这套知识拆解成项目实训,带着你从零搭建联机Demo,手把手排查每一个网络坑。毕竟,网络编程的坑,踩过才记得住。
关于火星人教育
火星人教育创办24年来,一直专注数字艺术与AIGC实战职业技能培训,开设课程涵盖AI漫剧创作、AIGC视觉设计、UE5游戏特效、室内全屋定制、MAYA三维动画、C4D动态设计、工业设计、NUKE影视后期、摄影摄像实训。北京、深圳双校区开设线下面授班,面向美术生、在校大学生及意向转行的职场人群,以项目化实训教学,夯实专业技能,助力就业与职业提升。想了解更多,欢迎致电010-65918670。



评论(0)