balenaEtcher 烧录失败怎么办：Flash Failed、校验失败与“Something went wrong”逐项排查

先说答案

balenaEtcher 烧录失败，大多数是这三类原因：文件不对（.7z、刷机包、下载不完整）、读卡器或存储卡有问题（写入中断、校验失败），以及Etcher 自身的启动问题。先按下面的表格对照你看到的提示，再到对应小节处理。

换了卡和读卡器还不行，就换一个写卡工具：Raspberry Pi Imager（三个系统都能用，写完自动校验）、Rufus（Windows），或 Linux、macOS 上的 整盘镜像校验与写卡脚本。

先判断你是哪种情况

Etcher 有中文界面，下面同时给出中文和英文界面的提示原文。

先做这三项检查

1. 核对 SHA-256：对下载的文件（例如 .img.xz、.img.gz 本身）核对本站页面上的值，方法见 如何核对下载文件的 SHA-256。不一致就重新下载。
2. 把镜像放在本机硬盘上：不要直接选网络共享、网盘同步文件夹或映射的网络驱动器里的文件。参与 Etcher 开发的人员在 GitHub 上解释过，写入时 Etcher 以管理员权限运行，可能看不到当前用户才能访问的映射盘。
3. 用本站的最新版：本站提供 balenaEtcher 2.1.8 的 Windows 安装包 balenaEtcher-2.1.8.Setup.exe、macOS 的 balenaEtcher-2.1.8-arm64.dmg（Apple 芯片）和 balenaEtcher-2.1.8-x64.dmg（Intel），以及 Linux 的 balenaEtcher-linux-x64-2.1.8.zip。

文件选不上或提示找不到分区表

Etcher 2.1.8 能直接读取 .img、.zip、.gz、.xz、.bz2、.raw、.bin、.iso、.wic 等格式，不支持 `.7z`，也不支持 .tar.gz 这类打包文件。

• .7z 和分卷压缩包：先用 7-Zip 解压出 .img，方法见 img.gz 怎么解压。
• 提示“找不到分区表”：英文原文为 It looks like this is not a bootable image. The image does not appear to contain a partition table。常见原因是选了厂商刷机包，比如瑞芯微的 update.img。这类文件不能写卡，要用厂商工具线刷，见 瑞芯微开发板 USB 线刷教程。本站固件页标着“整盘镜像（可直接写卡）”的文件才能用 Etcher 写入。
• 提示“这可能是 Windows 系统镜像”：Etcher 官方说明它只会逐字节复制镜像，Windows 安装镜像需要特殊处理才能启动，请改用 Rufus。

选完文件就报错

选好镜像后弹出标题为“打开源镜像时出错”（Error opening source）的窗口，内容是“打开 … 时出错”（Something went wrong while opening …），下面一行是 Error: (0 , h.requestMetadata) is not a function，而且换任何镜像都一样，问题不在文件，而在 Etcher 本身：维护者说明这表示 Etcher 的后台写入程序（etcher-util）没能启动。这个问题在 GitHub 上仍未关闭，1.18 到 2.1.7 的多个版本都有人遇到。

1. 换成本站的 2.1.8。它的更新说明里有两项针对 macOS 上 etcher-util 启动的改动（恢复 etcher-util 需要的权限、加强启动过程），但官方没有说明这个问题已经解决，换版本后仍报错就继续下一步。
2. Linux 用本站的 .zip 版：解压后运行 balenaEtcher-linux-x64 文件夹里的 balena-etcher。维护者曾确认，在其他安装包出这个错时，.zip 版可以正常使用。
3. 还是不行，就改用 Raspberry Pi Imager；Linux、macOS 也可以用 整盘镜像校验与写卡脚本。

压缩包损坏

提示“出了点问题。如果源镜像曾被压缩过，请检查它是否已损坏。”时，先核对 SHA-256。不一致就重新下载；一致的话，用 7-Zip 在压缩包上右键选“测试压缩包”。测试也通过，再换 Imager 写一次，排除 Etcher 本身的问题。

写到一半失败

界面显示“烧录失败。”（Flash Failed.）和“失败的烧录目标”（Failed targets），详情里通常是下面两种：

• “看起来 Etcher 失去了对磁盘的连接。它是不是被意外拔掉了？”（Looks like Etcher lost access to the drive. Did it get unplugged accidentally?）
• “看起来 Etcher 无法写入磁盘的这个位置。此错误通常是由故障的磁盘、读取器或端口引起的。”（Looks like Etcher is not able to write to this location of the drive.）

按顺序排查：

1. 读卡器直接插在电脑的 USB 口上（台式机用机箱背面的口），不要经过扩展坞、显示器上的 USB 口或集线器。
2. 换一个读卡器。参与 Etcher 开发的人员在 GitHub 上提到，便宜的多合一读卡器经常不稳定。
3. 换一张存储卡。
4. 写入过程中不要打开卡里的文件，也不要让别的软件访问这张卡。
5. 点“重试烧录失败目标”（Retry failed targets）重新写一次。

校验失败

写完后 Etcher 会把数据读回来比对（界面显示“正在验证……”）。提示下面这段话就是校验失败：

写入已成功完成，但 Etcher 在从磁盘读取镜像时检测到潜在的损坏问题。请考虑将镜像写入其他磁盘。
The write has been completed successfully but Etcher detected potential corruption issues when reading the image back from the drive.

这说明卡上的数据和镜像不一致，这张卡开机很可能出问题，不要跳过校验继续用。Etcher 官方的建议就是换一个存储设备：

1. 先换读卡器和 USB 口，用同一张卡再写一次。
2. 还是失败，就换一张卡。
3. 想确认是不是 Etcher 的问题，可以用 Raspberry Pi Imager 写同一个文件，它写完也会自动校验。

容量不够

提示“磁盘空间不足”，或在选卡时显示“空间太小”“所选的镜像比目标盘大了 …”，说明镜像解压后比卡还大。换一张更大的卡。例如树莓派系统的桌面版解压后约 6–7 GB，树莓派官方建议用 32 GB 以上的卡，详见 树莓派系统版本区别。

写过系统的卡容量变小了，怎么恢复

写入系统镜像后，Windows 里只能看到一个几百 MB 的小分区，这是正常的：卡里其余空间是 Linux 分区，Windows 读不出来，容量没有丢。想把卡恢复成普通存储卡，选下面一种方法。

警告下面的操作会清空整张卡。一定看清容量再选，别选成电脑硬盘或移动硬盘。

方法一：Raspberry Pi Imager 的“格式化”（Windows、macOS、Linux 都能用）

1. 打开 Raspberry Pi Imager，在“设备”里随便选一个型号，点“下一步”。
2. 在“操作系统”列表里选“格式化（Erase）”，说明是“把 SD 卡格式化为 FAT32”（Format card as FAT32）。
3. 在“储存设备”里选你的卡，点“写入”，再点“我理解，擦除并写入”（I understand, erase and write）。

应看到：完成后电脑上出现一个完整容量的 FAT32 磁盘。

方法二：Windows 用 diskpart

警告diskpart 的 clean 会立即删掉所选磁盘上的全部分区，没有确认提示，也不能撤销。选错盘号会清空电脑硬盘或移动硬盘。下面第 1 步和第 4 步不要省略。

1. 先拔掉其他 U 盘、移动硬盘和存储卡，只插要恢复的这一张卡。
2. 按 Win 键输入 diskpart，以管理员身份运行。
3. 在弹出的 diskpart 窗口里输入 list disk，按“大小”一列找和卡容量接近的那一项（显示值通常略小于卡上标的容量）。磁盘 0 一般是电脑本身的硬盘，几乎不会是存储卡。拿不准时，拔下读卡器再运行一次 list disk，消失的那一项就是卡；插回去后再运行一次 list disk，用这时显示的编号。
4. 输入 select disk N（N 换成卡的编号），再输入 detail disk 核对：型号应是读卡器或存储卡，下方卷列表里不应出现 C 等电脑硬盘的盘符。对不上就停下，不要往下做。
5. 确认无误后依次输入：

clean
create partition primary
format fs=fat32 quick
assign
exit

应看到：最后出现一个新盘符，容量和卡一致。

• 大容量卡提示卷太大、不能格式化成 FAT32 时，把 fat32 换成 exfat 再运行 format 那一行。

方法三：macOS 用 diskutil

警告eraseDisk 会清空整块磁盘，编号填错会抹掉别的磁盘。

1. 打开“终端”，插卡前后各运行一次 diskutil list，新出现的那一块就是卡。它通常标着 (external, physical)，容量和卡一致。记下 /dev/diskN（N 是数字）。不要选 disk0 等标着 internal 的磁盘。
2. 运行（把 N 换成你的编号）：

diskutil eraseDisk FAT32 UNTITLED MBRFormat /dev/diskN

应看到：最后提示 Finished erase，桌面上出现名为 UNTITLED 的磁盘。

方法四：Linux

警告dd 写错设备会直接破坏那块磁盘上的数据。

1. 插卡前后各运行一次 lsblk，新出现的那一项就是卡，容量要对得上。USB 读卡器一般是 /dev/sdX，电脑自带的读卡器一般是 /dev/mmcblk0。
2. Etcher 官方给出的方法是先卸载卡上的分区，再清掉开头的分区表（把 /dev/sdX 换成你的卡；自带读卡器的分区名是 /dev/mmcblk0p1 这种形式，卸载时写 /dev/mmcblk0p*）：

sudo umount /dev/sdX*
sudo dd if=/dev/zero of=/dev/sdX bs=512 count=1 conv=notrunc

最后用系统自带的“磁盘”工具在这张卡上新建分区并格式化。

常见问题

• Etcher 能不能把剩余空间分出来用：不能。Etcher 维护者说明，在空闲空间上建分区不在 Etcher 的功能范围内。树莓派系统等镜像第一次开机会自动扩展分区；OpenWrt 等系统按对应型号教程处理。
• 设置里的“Trim unallocated space on raw images (in ext-type partitions)”是什么：这是 Etcher 设置（齿轮图标）里的一项，默认开启，写入带 ext 分区的镜像时跳过没用到的空间，所以速度会显得更快。中文界面里这一项也显示英文。
• Linux 提示 `No polkit authentication agent found`：Etcher 官方说明它需要系统里有 polkit 认证代理来弹出密码框，请为你的桌面环境安装对应的 polkit 认证组件后再试。
• 写完插上电脑提示要格式化：点“取消”，不要格式化。这是 Windows 读不懂卡上的 Linux 分区，不代表写入失败。
• 换工具写：Windows 可以用 Rufus 4.15（64 位选 rufus-4.15.exe，ARM 设备选 rufus-4.15_arm64.exe）；三个系统都可以用 Raspberry Pi Imager 2.0.12 的“使用自定义镜像”；Linux、macOS 还可以用 整盘镜像校验与写卡脚本，它会先核对 SHA-256，并拒绝刷机包和系统盘。完整写卡步骤见 如何把开发板系统镜像写入 SD 卡。

资料来源

按 balenaEtcher 2.1.8 源码（中英文界面文字、支持的文件格式、默认设置）、balenaEtcher 官方用户文档与常见问题（含“恢复损坏的磁盘”）、GitHub 上 balenaEtcher 维护者在相关问题中的回复、2.1.8 版更新说明、Raspberry Pi Imager 2.0.12 源码与树莓派官方安装文档、微软 diskpart 命令文档整理（2026-10-22 查阅）。

提示本页按官方文档和源码整理，本站没有在实机上测试。各型号能否从写好的卡启动，以对应型号教程和厂商说明为准。