推送 EPUB 文件到 KINDLE 的常见失败原因及解决方法

本文根据小伙伴们提供的样本文件汇总了一些具有代表性的问题，并为每个问题提供了相应的解决方法。这些问题被分成了两大类，分别是“导致推送失败的问题”和“导致内容有误的问题”。前者主要解决推送不可达的问题，后者主要解决虽推送成功内容却存在可读性问题的问题。

本文会用到 Sigil 这款软件，如果其它软件（如 Calibre）有同等功能也可以作为替代。

一、导致推送失败的问题

推送失败是指无法将 EPUB 文件成功推送到 Kindle，通常你会收到亚马逊的一封题为“您发送到 Kindle 的文档有问题”的退信，内容除了一个格式支持列表，未提供对解决问题有价值的信息。

一个 EPUB 文件可能同时存在下面这些问题，你可以在推送失败使逐一排查和修复。

1、EPUB 中的某些文件不符合规范

亚马逊的个人文档服务对推送的 EPUB 文件有较强的容错机制，即便有些内容不符合 EPUB 规范，一般情况下也能被正常处理，但是唯独对 EPUB 2.0 的导航控制文件 toc.ncx 及 EPUB 3.0 的导航文档 nav.xhtml 比较敏感，如果这两个文件存在“错误”，就会大概率导致推送失败。

这是导致 EPUB 推送失败最常见的问题，也是首先要尝试解决的问题。具体解决方法如下：

用 Sigil 打开 EPUB 文件，依次点击菜单【工具（Tools） → 目录（Table Of Contents） → 生成目录…（Generate Table Of Contents…）】（或按快捷键，Windows 是【Ctrl + T】，macOS 是【Command + T】。不过需要注意，这种方式可能会破坏目录层级。

最后点击左上角的软盘图标按钮（或按快捷键，Windows 是【Ctrl + S】，macOS 是【Command + S】）保存修改后的文件。

关于此问题的详细解释可参考《如何快速无损修复推送失败的 EPUB 格式电子书文件》一文。

2、XHTML 文件名含空格和中文字符

如果 EPUB 文件被插入了广告页面，且文件名带有空格和中文字符，也会导致推送失败。解决方法是，用 Sigil 打开 EPUB 文件，直接将带空格和中文字符的 XHTML 页面删掉再保存即可。

3、OPF 文件中的 language 元素有误

用 Sigil 打开 EPUB 文件，检查其 OPF 文件（通常文件名为 content.opf）元数据中的 <language> 元素，如果该元素缺失，或者其内容部分未指定语言代码，或指定了错误的语言代码（如下所示）都会导致推送失败。

<dc:language>und</dc:language>

解决方法为用 Sigil 编辑 OPF 文件，如果发现缺失 <language> 元素，则在 <metadata> 元素中添加如下所示的代码，注意语言代码以实际为准。如果 <language> 元素中的语言代码有误，则改成有效的语言代码，如中文的 zh，英文的 en，更多请参考 ISO 639-1 语言代码列表。

<dc:language>zh</dc:language>

你也可以通过 Sigil 的菜单添加或修改语言元素。首先点击【工具（Tools）→ 元数据编辑器…（Metadata Editor…）】调出元数据编辑界面。如果缺失 <language> 元素，可点击【添加元数据（Add Metadata）】按钮，选择“语言（Language）”，点击【OK】按钮后再选择“中文 – 中国（Chinese – China）”，点击两次【OK】按钮完成添加。注意不要重复添加。

如果 <language> 元素中的语言代码有误，双击“语言（Language）”的“值（Value）”相应的字段，选择“中文 – 中国（Chinese – China）”，点击【OK】按钮完成修改。

最后点击左上角的软盘图标按钮（或按快捷键，Windows 是【Ctrl + S】，macOS 是【Command + S】）保存修改后的文件。

当然，除了是用 Sigil 外，你也可使用 Calibre 的电子书元数据功能实现同样的目的。

4、OPF 文件中出现重复的 item 元素

如果 OPF 文件中的 <item> 元素重复也会导致推送失败，将那些元素去重就可以成功推送了。Sigil 貌似没有工具可以检测这个问题，你可以尝试用 KindleGen 转换有问题的 EPUB 文件，如果有 item 元素出现重复，软件会提示你具体是哪一个重复了，提示信息如下所示：

Error(xmlmake):E27012: Item or process id already used: 180630.jpg

5、在 CSS 中隐藏的字符数超过了限制

Kindle 电子书对 CSS 声明 display:none; 的使用有限制，隐藏内容区块中的字符不能超过 10000 个，否则会导致推送失败。因此，建议删除 CSS 文件中所有 display:none; 声明。

6、XHTML 中的元素含有不兼容属性

检查 XHTML 中是否有元素像下面那样使用了属性 data-amznremoved，如果有的话需要将其移除，否则会导致推送失败。这可能是 Send to Kindle 服务无法正确处理此属性导致的。

<span class="jpchar" data-amznremoved="mobi7">A Sample</span>

7、XHTML 文件中的 body 标签含 ID

在 EPUB 文件的 toc.ncx 文件中，有些 <content> 元素的 src 属性值所指向的 XHTML 文件路径含有 URL 片段，即类似路径 text/part0000.html#test_1 中的 #test_1，如果其对应的 id 属性在 <body> 元素上，可能会导致推送失败。解决方法是，将 <body> 元素上对应的 id 值移至其子元素上，或直接删除路径中片段部分（即 # 和其后的字符）。

最后点击左上角的软盘图标按钮（或按快捷键，Windows 是【Ctrl + S】，macOS 是【Command + S】）保存修改后的文件。

8、NCX 文件中包含的章节目录过多

如果你要推送的电子书有着成百上千的章节，大概率也会推送失败。由于是亚马逊服务器方面的限制，目前没有太完美的解决方案。变通的解决方案有两种：一种是编辑 EPUB 文件中的 NCX 文件，删减 <navPoint> 元素的数量，这种方法的缺点是会影响 Kindle 目录导航功能；另一种是将 EPUB 文件化整为零，将电子书分割成多份，这种方法的缺点是会多出很多工作量。

二、导致内容出错的问题

有时 EPUB 文件即便是推送成功，其内容也存在可读性问题，如乱码、目录层级有误等。

1、电子书内容出现乱码

推送的电子书出现乱码的一般表现为，中文电子书全部乱码，英文电子书部分标点符号乱码。一般情况下，这是由于 EPUB 文件中的 XHTML 文件没有指定 UTF8 编码导致的。

解决方法为：下载并安装 EPUB 编辑器 Sigil，然后用 Sigil 打开 EPUB 文件，依次点击菜单【工具（Tools）→ HTML 重新格式化（Reformat HTML）→ 改进所有 HTML 文件（Mend All HTML Files）】，让 Sigil 自动修补所有 HTML 文件，最后保存再推送就可以了。

2、电子书目录层级有误

如果电子书的目录层级与你的预期不相符，你可以用 Sigil 的目录编辑功能【Tools（工具） → 目录（Table Of Contents）→ 编辑目录…（Edit Table Of Contents…）】调整一下。

通过键盘上的上下方向键（或通过鼠标点击）可选中标题；
按住 Ctrl 键加上下方向键调整标题的顺序（也可以点击界面右侧的上下方向按钮）；
左右方向键调整标题的缩进（也可以点击界面右侧的左右方向按钮）；
编辑完成后点击【OK】按钮保存即可。

最后点击左上角的软盘图标按钮（或按快捷键，Windows 是【Ctrl + S】，macOS 是【Command + S】）保存修改后的文件。

3、电子书导航目录缺失

如果推送 EPUB 电子书到 Kindle 后，无法通过 Kindle 的“前往”功能进行目录导航，有可能是因为 EPUB 的导航文件（一般是 toc.ncx）中的 URI 带有片段（如下所示）导致的。

text/part0001.html#UGI0-1af7590487e04e47b91ab6bb431b89f3

虽然 EPUB 规范上这样做是没错的，但是估计是亚马逊服务器的怪癖，在转换格式时丢失了导航目录。解决方法有两种，一种是删除 URI 中的片段，另一种是重新生成目录。具体方法如下：

删除 URI 片段的具体方为，用 Sigil 打开 EPUB 文件，双击打开左侧栏中的文件 toc.ncx，然后在“查找”输入框中输入正则表达式 #[^"]*，“替换”输入框留空，“模式”下拉菜单选择“正则表达式”，最后点击“替换”输入框后的第二个按钮全部替换并保存即可。

另一种用 Sigil 的目录生成工具重新生成一遍目录，具体方法为，依次点击菜单【工具 → 目录 → 生成目录】并保存即可。注意，这种方式在某些情况下可能会改变目录层级。

由于受限于 EPUB 文件样本数量，以上这些问题无法覆盖所有情况，如果你在使用以上方法修复 EPUB 文件后仍然推送失败，可以尝试使用 Sigil + EpubCheck 插件检测并修复 content.opf 和 toc.ncx 这两个文件存在的所有问题，一般均可成功推送。

另外，也可以尝试使用 Calibre 格式转换功能，现将 EPUB 格式转换成 AZW3，然后再转换成 EPUB 格式，有时也能解决推送失败的问题。

4、电子书字体显示异常

如果推送到 Kindle 的电子书显示的字体不一致，比如黑体宋体掺杂在一起，有可能是电子书的实际语言与原数据中的语言不一致导致的，比如某本书的文本实际上是中文，但是原数据中的语言却是英文。你可以使用 Sigil 或 Calibre 的原数据编辑功能修改原数据中的语言，使其与实际语言保持一致，具体方法请参考“3、OPF 文件中的 language 元素有误”。

如果你有更好的解决方案或小技巧，也欢迎在本文下方留言分享。