OpenWrt 刷写安全
没有查清镜像检查失败原因前，不要强制升级
OpenWrt 的 Image check failed 可能指向错误的 target、profile、硬件版本、镜像类型、分区布局，也可能表示本次升级不能保留配置。必须结合完整报错和准确设备说明判断。
先停下，不要直接使用 sysupgrade -F。除非官方 release notes 或准确设备页明确要求你的型号和升级路径使用强制参数，否则不要用它消除镜像警告。它会跳过兼容性检查，却不能把错误固件变成正确固件。
这是一份判断指南，不是强刷教程。保持供电，保存完整报错；在确认检查失败原因前，不要开始下一次写入。
1. Image check failed 实际表示什么
OpenWrt 检查的不只是文件名。根据设备和版本，检查内容可能包括镜像元数据、签名、支持设备身份、device tree 兼容性、镜像大小，以及旧配置能否安全迁移。
要阅读报错前后的完整内容。“必须不保留配置升级”和“设备镜像不匹配”“分区迁移不受支持”或“下载损坏”不是同一件事。
2. 逐项核对固件身份
| 检查项 | 为什么重要 |
|---|---|
| Target 和 subtarget | 它们对应处理器家族和平台构建；产品名相似不代表镜像可以互换。 |
| Device profile | Profile 包含设备支持身份和设备专用镜像规则。 |
| 硬件版本 | V1、V2、区域版本和近似型号可能使用不同组件或闪存布局。 |
| 镜像类型 | factory、sysupgrade、initramfs 和厂商 recovery 镜像用于不同安装阶段。 |
| 分区布局和镜像大小 | 新版本可能改变分区布局，设备也可能有专用大小限制；强制写入不能修复这种不匹配。 |
从官方 Firmware Selector 或 release 路径重新下载并校验 checksum。不要通过重命名其它型号的镜像，让恢复页面勉强接受文件。
3. 有些升级必须清除配置
镜像本身可能正确，但旧配置不适合保留。OpenWrt 当前 release notes 列出了需要 clean upgrade、重新 factory install 或特殊 installer 的设备与 target，例如 24.10.7 的 ipq806x 迁移、25.12.5 的 BPI-R4 配置处理，以及 Linksys E8450 / Belkin RT3200 等设备的独立迁移流程。
4. 为什么 -F 不是通用解决方案
OpenWrt 将 -F 记录为兼容性检查的 override。只有官方设备专用流程明确要求时，它才可能合理。例如 OpenWrt 25.12.5 只对部分 TP-Link RE355、RE450 的特定升级路径给出了范围很窄的强制升级说明。
这个参数不能纠正错误 target、错误硬件版本、超出大小限制的镜像、不兼容分区布局，也不能替代设备需要的 installer 或厂商恢复流程。如果官方说明没有解释为什么可以安全跳过检查，就应该停止并重新核对。
5. 强制刷写或升级后失联时怎么检查
不要一边猜测一边连续上传不同镜像。保留当前仍可使用的访问方式，先识别 bootloader 和实际恢复机制。
6. Router Recovery 能处理与不能处理的边界
Router Recovery 可以帮助准备本地 macOS TFTP Server 恢复环境：网线直连、Mac 临时静态 IP、用户选择的固件文件夹和文件名，以及恢复模式检查。
它不能判断不兼容 OpenWrt 镜像是否安全，不能绕过 OpenWrt 验证、重写分区布局或执行设备专用 installer，也不能保证恢复成功。恢复取决于准确型号、硬件版本、可信固件和官方 bootloader 路径。
已核对的官方资料
核对日期：2026 年 7 月 18 日。资料包括 OpenWrt sysupgrade 技术说明、OpenWrt owut / sysupgrade 指南、OpenWrt 25.12.5 release notes 和 OpenWrt 24.10.7 release notes。
发现新问题后，release notes 可能继续更新。刷写前应重新查看当前说明和准确设备页。