技术博客

网络调试：模拟延迟与丢包，本地把 200ms 延迟玩出来的方法

第 123 / 149 篇 · 2025-09-22 · godot · 网络同步网络调试实战

联机游戏最折磨人的地方：所有网络 bug 都只在"别人电脑上、特定网络下"出现。你这边 localhost 双开一切正常，玩家那边 4G 网络掉一次线，游戏就卡在"正在连接"半小时。根源是开发环境太好了——RTT 不到 1ms，丢包率为零，任何时序问题都被光速传输掩盖。这篇讲怎么把烂网络搬进本地开发机。

先泼一盆冷水：Godot 本身没有内置的延迟/丢包模拟。ENetMultiplayerPeer 和 WebSocketMultiplayerPeer 都没有相关参数，引擎的 debug 设置里也没有对应开关（这和 Unity 的 Network Emulation 面板不一样）。Godot 官方文档的建议是借助系统层工具。所以方案要么自己写，要么用系统工具。

方案一：UDP 代理（应用层劣化）

最 Godot-native 的做法是在两个实例之间塞一个UDP 代理节点：A 实例连到代理，代理转发到 B 实例，转发途中施加延迟、抖动和丢包。因为 ENet 是无连接的 UDP 协议，代理不需要理解任何游戏逻辑，只做四元组转发。

# 伪代码：运行在第三个 Godot 实例里的 UDP 代理
# 收到包后不立即转发，而是按 (delay + rand(-jitter, +jitter)) 调度
func _on_packet(from_peer, data):
    if randf() < loss_rate:
        return  # 模拟丢包：直接丢弃
    var actual_delay := delay_ms + randf_range(-jitter_ms, jitter_ms)
    get_tree().create_timer(actual_delay / 1000.0).timeout.connect(
        func(): forward_to_other_end(from_peer, data)
    )

这个方案的优缺点都很鲜明。优点：跨平台（纯 GDScript）、不需要 sudo、可以做成场景里的一个开关按钮随时切换、还能记录经过的包做回放（和七-8 的录制思路合流）。缺点：代理自己引入的调度误差在高频包下会变形——Godot 的 SceneTreeTimer 精度受帧率影响，actual_delay 抖动可能比你设定的还大。对 20Hz 级别的同步包够用，对 60Hz 格斗游戏的帧级模拟就力不从心。

我在项目里给代理加了一个 debug 面板：两个 slider 调 delay 和 loss，一个按钮"掐断 3 秒"，测试时挂在副屏上随手拖。

UDP 代理方案：游戏实例间插入可编程的劣化层 Godot 实例 A create_client(代理端口) UDP 代理 delay + jitter loss + 掐断 Godot 实例 B create_server(真实端口) 典型劣化参数 良好 WiFi：delay=15ms，jitter=5ms，loss=0.1% —— 日常开发默认值 4G 移动网：delay=80ms，jitter=30ms，loss=3% —— 地铁通勤场景 跨国对战：delay=150ms，jitter=50ms，loss=8% —— 亚服 vs 美服

方案二：系统级工具

想让劣化对进程透明（不改游戏代码），就得在操作系统层动手：

macOS / iOS：pfctl + dnctl（dummynet）可以做全局限流，但要 sudo 且规则晦涩。日常开发我用 Apple 的 Network Link Conditioner（Hardware Tools 里的面板，Xcode Additional Tools 附带），GUI 里点选"3G""Very Bad Network"等 preset，还能自定义带宽/延迟/丢包。iOS 真机上也有同名设置项，移动开发必装。

Windows：社区工具 clumsy 是标配——基于 WinDivert 在用户态截获包，GUI 调延迟/抖动/丢包，不用装驱动签名折腾。Godot 官方文档的联机调试建议里点名推荐的就是它。

Linux：内核自带 tc qdisc add dev lo root netem delay 100ms loss 5%，一行搞定，还能按端口过滤只劣化游戏流量。

系统层方案的通病是粒度粗：要么全系统、要么按端口/IP，做不到"只对玩家 2 的连接劣化"。测房主迁移、非对称网络（一端好一端坏）这类场景时，还是方案一的代理灵活。

方案三：Chaos 测试

前两层的参数是确定性的：delay 固定 200ms，丢包率固定 5%。但真实网络的恐怖不在于"平均很差"，在于不可预测——延迟突然尖峰、连接毫无征兆地 reset、对端进程被系统杀掉。Chaos 测试就是把这种随机性引入自动化测试：

# 每 5–15 秒随机改变代理参数，持续 10 分钟
func _chaos_network(proxy: UdpProxy) -> void:
    while true:
        await get_tree().create_timer(randf_range(5.0, 15.0)).timeout
        if randi() % 100 < 10:
            proxy.loss = 1.0                    # 10% 概率：掐断 0.5–3 秒
            await get_tree().create_timer(randf_range(0.5, 3.0)).timeout
            proxy.loss = 0.0
        else:
            proxy.delay_ms = randf_range(50, 300)
            proxy.jitter_ms = randf_range(10, 80)
            proxy.loss = randf_range(0.0, 0.15)

跑这个的时候，游戏不能崩溃、不能永久卡死、不能出现"我看到你动了但你没动我"的灵异状态——每次跑完检查状态机一致性（双方血量、位置误差是否在阈值内）。这套东西在 CI 里跑一晚，能挖出比 QA 手动测试一周还多的 bug。

观测：先测量再劣化

劣化只是手段，观测才是目的。ENet 侧有现成的统计接口：ENetPacketPeer.get_statistic(ENetPacketPeer.PEER_ROUND_TRIP_TIME) 拿实时 RTT，PEER_PACKET_LOSS 拿丢包率，把这两个数打到 HUD 上，开发时肉眼就能看到当前链路质量。更系统的做法是把每局对局的网络统计（平均 RTT、P95 RTT、丢包率、断连次数）写进遥测日志——发布后这些数据和你埋点的玩家流失率算个相关系数，会告诉你该优先优化哪段网络代码，而不是凭感觉。

本文基于 Godot 4.3–4.4（引擎无内置网络劣化，以官方文档为准）；clumsy 基于 WinDivert，Network Link Conditioner 随 Xcode Additional Tools 发布，tc/netem 为 Linux 内核 qdisc。