故障排除

先解决症状，再解决问题。在大多数情况下 医生 页面已经知道出了什么问题 - 在手动处理此列表之前检查那里。如果这里没有帮助，请从以下位置导出支持包 诊断 和 打开反馈报告.

视窗11 该应用程序根本不会启动

如果 Windows 安装程序运行良好，但双击 FFB-Bridge 快捷方式绝对不执行任何操作 - 没有窗口，没有错误，没有 SmartScreen 提示 - 几乎可以肯定你正在运行 Windows 11 智能应用程序控制 (SAC) 已启用。 SAC 会默默地阻止任何未经受信任发布者进行代码签名的应用程序。 Beta 版本尚未签署（它位于 1.0 路线图上），因此 SAC 拒绝启动它们。

解决方法是关闭智能应用程序控制足够长的时间以安装并首次运行该应用程序。最近的 Windows 11 累积更新还允许您在事后重新打开 SAC，而无需重新安装 Windows，这是对早期版本的改进，在早期版本中，切换是永久的。微软自己的指导：

Microsoft：智能应用程序控制常见问题解答

一旦 SAC 关闭，FFB-Bridge 应用程序就会启动，最重要的是， 不断发射 重新启用 SAC 后 — SAC 仅检查以前未见过的应用程序。所以解决方法是一次性的。一旦代码签名的安装程序随 1.0 一起发布，此部分就会消失。

棍子根本不动

是武装的吗？

顶部条中的驾驶舱 ARM 仪表必须读取 武装 （琥珀色渐变）。如果读到 解除武装 （灰色字形，暖边框），单击并确认。如果读到 故障 （红色），请参阅下面的“Stick 正在工作，突然停止”——先决条件刚刚被删除。

是否检测到设备？

顶部条中的设备指示灯应为绿色（“就绪”）。如果它是红色的（“断开连接”）：

• 拔下并重新插入棒；桥接器在一两秒内重新检测。
• Confirm the VID/PID in your OS device manager (045E / 001B).
• Linux Doctor 的 udev-rule 行应该是绿色的；如果它是红色的，请运行一键安装程序。
• 窗户 关闭任何其他声称力反馈的应用程序 - DIY 测试仪、一些操纵杆诊断实用程序将拥有独占访问权限。

是否已连接 SIM 卡？

顶部条中的 SIM 指示灯应呈绿色（“Sim 已连接”）。如果没有，请参阅 MSFS 设置指南 或 X-Plane设置指南 为您的SIM卡。与此同时， 模拟 SimConnect 页面将让您确认管道的其余部分正在工作。

MSFS 连接但没有任何力量感觉正确

如果摇杆正在移动，但感觉力不正确，则问题通常是轮廓或机身不匹配：

• 从距离您的飞机最近的内置启动器开始：Cessna 172 Skyhawk (G1000)、Daher TBM 930、Beechcraft King Air 350i、Airbus A320neo 或波音 747-8 InterContinental。大多数“错误”感觉来自于针对不同飞机类别进行调整的配置文件。
• 检查仪表板的操纵杆活动面板。它将基线弹簧与轴载荷、发动机隆隆声、地滚、湍流和机械一次性冲击等动态通道分开。如果您未预料到的效果显示为活动状态，则模拟卡将报告正在驱动这些效果的遥测数据。
• 第三方飞机有时会跳过实施标准 SimVar。桥可以容忍这种情况（缺少变量默认为零），但某些效果将因此无法触发。这是一个已知的限制，我们无法在桥梁中轻松解决 - 报告特定的飞机，以便我们能够表征。

托盘图标不出现 (Linux)

有些桌面环境并没有开箱即用的系统托盘主机——GNOME Wayland 是其中最大的一个。当桥检测到这一点时，它会在窗口顶部显示一个横幅，解释关闭将直接退出应用程序（而不是默默地隐藏），并且关闭按钮会做出相应的行为。在 GNOME 上安装 AppIndicator 支持扩展以恢复托盘图标；在 KDE、Xfce、Cinnamon、MATE 和 Budgie 上，托盘可以开箱即用。

医生说 SimConnect 可以访问，但没有数据流

网桥正在连接（接受 TCP hello），但数据流未启动。在 MSFS 2024 上，这通常意味着 SimVar 订阅失败 - 通常是因为 MSFS 尚未完成其内部 SimConnect 服务器的启动。等待 MSFS 进入主菜单（不仅仅是介绍屏幕），然后重试。

检测到 X-Plane但没有数据流

如果 SIM 灯短暂变绿，然后又回到“没有 sim 运行”状态，而遥测实际上没有流动，则防火墙通常会吃掉我们的 UDP 数据包。尝试：

• 暂时关闭防火墙进行确认。
• 将网桥进程上的 UDP 49000 出站列入白名单。

窗户 武装或起飞后不久坠毁

Pre-beta.10 issue. Earlier Windows hardware-mode builds created a large retained DirectInput effect table — one physical effect for each logical simulator cue. On some Sidewinder FFB2 / Windows pid.dll stacks, that call pattern could crash during active flight, often around CreateEffect, SetPeriodic, or native ACCESS_VIOLATION breadcrumbs. This is not an MSFS issue and not a sign that your stick's firmware is bad.

窗户 MSFS 暂停或长时间卡顿后力量消失

Beta.11 专门针对此类错误。 MSFS 暂停和主动暂停现在立即抑制动态效果，而摇杆保持中性默认弹簧。恢复时，DirectInput 弹簧参数会在效果重播之前重新上传，因此俯仰和横滚居中都会恢复。

如果在 beta.11 或更高版本上恢复后仍然感觉不存在侧倾力，请在复制后立即导出支持包，并描述仪表板当时是否显示轴载荷、基线弹簧或动态通道。这告诉我们管道是否变得安静或设备驱动程序丢失了轴。

Beta.10 修复了架构：硬件模式现在使用一个矢量常量、一个两轴弹簧和一个小型惰性周期池，而不是一个大型保留表。如果您在 beta.10 或更高版本上仍然看到此问题，请打开 Doctor → 硬件兼容性，运行 测试硬件效果，然后切换到 软件混合期刊 如果测试失败或者桥接器在下次启动时提供恢复。另请发送支持包，以便我们能够描述剩余驱动程序堆栈的特征。

退出后效果会继续播放约 30 秒

Pre-beta.9 issue. On Win11 + the FFB2 driver, the bridge's per-effect cleanup on quit was, on this stack, blocking each call for the effect's full firmware playback duration — so in-flight rumble or buffet effects ran out their natural ~32 second timer after the bridge closed, leaving the stick audibly active on the desktop with no app driving it. Fixed in beta.9 — the shutdown path now skips per-effect work entirely and uses two device-level commands (halt-all + reset firmware effect table) that return immediately. Same fix applies on a native crash via the Vectored Exception Handler. If you're seeing this on beta.9 or later, please file a feedback report.

窗户 Crash on quit citing 0x80131506

Pre-beta.9 issue. On a fraction of installs, the bridge would crash with a Windows Error Reporting popup citing coreclr.dll and exception code 0x80131506 the moment you clicked Quit or closed the window. Root cause: the UI thread and the runtime's control loop were both calling into DirectInput at the same time on shutdown, and the COM marshaller eventually noticed and tore the process down. Fixed in beta.9 — all DirectInput access now serialises through a single lock at the device boundary so the two threads can never race the marshaller. If you're seeing a 0x80131506 on quit on beta.9 or later, please file a feedback report.

启动时崩溃

下次启动恢复流程：如果上次启动崩溃，桥接器会在下次启动时显示崩溃报告对话框，其中包含堆栈跟踪和 通过反馈表发送 按钮。单击它；该表单预先填充了崩溃日志。

如果应用程序在对话框出现之前崩溃，您将直接需要崩溃日志文件：

• 窗户 %LOCALAPPDATA%\ffb-bridge\crashes\
• Linux ~/.local/share/ffb-bridge/crashes/

Attach the most recent .log file to a feedback report.

“桥梁无法跟上”警告

当控制回路速率下降时，诊断会发出警告。我们看到的原因：

• 同一核心上的另一个进程正在消耗 CPU——浏览器选项卡、编译。
• On Linux, a cpufreq governor is clocking down the CPU. Switch to performance or schedutil.
• 在虚拟化环境中运行，无法为来宾提供可靠的 20 毫秒时间片。

插入多个 FFB2 棒

最先找到的获胜 — 桥接器获取第一个匹配的 VID/PID 并驱动它。一个可以消除歧义的 UI 就在列表中；现在，物理上断开除您想要的那个以外的所有连接。

还卡住了吗？

从以下位置导出支持包 诊断 和 打开反馈报告. The bundle contains the session log, crash log (if any), Doctor output, and system info — it's exactly what we need to reproduce without shipping you test builds.