无法加载 SWF：路径问题、文件损坏、中文路径

桌面版：从本地打开失败

先做最简单的事

1. 把 SWF 挪到全英文、无空格、无特殊字符的路径（比如 C:\games\test.swf）
2. 重试——中文路径、#、&、括号、空格这些字符 Ruffle 的文件解析偶尔会出问题
3. 如果用命令行启动，直接把路径粘进命令行（不要用快捷方式的起始目录）

文件可能已经损坏

旧 Flash 内容的 SWF 有些是 10-15 年前从网站上扒下来的，保存时可能已经是坏的：

1. 用 JPEXS Free Flash Decompiler（开源 SWF 反编译工具）打开那个 SWF
2. 能正常列出 timeline、classes、resources → 文件本身是好的，问题在 Ruffle
3. JPEXS 也打不开 → 文件本身坏了，重新从来源下载一份

命令行加 --verbose 看日志

ruffle.exe --verbose C:\games\test.swf

红色关键词：

• ParseError at tag X → SWF 内部结构不合法，Ruffle 解析器在某个 tag 位置报错
• Unable to read file → 路径问题或权限问题
• Version 20+ → SWF 版本号很高（Flash Player 10+ 的 version 20+），某些新 tag Ruffle 还没解析器

桌面版：远程加载失败

URL 检查

直接把 URL 粘到浏览器地址栏里——能下载到 .swf 说明 URL 是对的；404 / 403 → URL 本身有问题。

跨域 / 防盗链

某些网站对 .swf 请求有防盗链——没有正确的 Referer 头就拒绝。在 Ruffle 的「打开 → URL 标签」里，把浏览器里访问这个 SWF 时的 Referer 复制进来。

需要登录 / Cookie

某些 Flash 内容需要先登录才能访问 SWF。把浏览器 DevTools 里当前页面的 Cookie 头复制到 Ruffle 的 Cookie 输入框。

HTTPS 混合内容

如果页面是 HTTPS 但 SWF URL 是 HTTP，Ruffle 默认会自动升级成 HTTPS（upgradeToHttps: true）。但如果升级后那个 HTTPS URL 不存在 → 加载失败。临时关一下 HTTPS 升级试试（URL 加载器里有个勾选项）。

网站嵌入：加载失败

F12 → Console 面板：

• 404 Not Found → SWF URL 写错了、或路径相对位置不对
• CORS policy blocked → 跨域问题（下一节专门讲）
• Mixed Content blocked → HTTPS 页面里的 HTTP SWF，开 upgradeToHttps

快速自查清单

• [ ] 把 SWF 挪到纯英文路径再试
• [ ] JPEXS 反编译一下看文件本身坏没坏
• [ ] 命令行加 --verbose，看 ParseError 还是 NetworkError
• [ ] 远程加载的话浏览器直接访问那个 SWF URL 确认能下载
• [ ] 从 embedder 场景切到 standalone 场景试（反之亦然）