赞赏

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

更新时间： 编辑：书伴 分类：推送专题 50 条留言
推送 EPUB 文件到 Kindle 的常见失败原因及解决方法

书伴之前发布了一篇文章《如何快速无损修复推送失败的 EPUB 格式电子书文件》，文中提供的修复方法可解决大部分推送 EPUB 文件后收到亚马逊系统退信的问题。但是此方法并不能覆盖所有问题，随着小伙伴不断向书伴提供样本文件，更多推送 EPUB 文件相关的问题得以显现。

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

本文会用到 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、HTML 文件名含空格和中文字符

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

3、HTML 文件中的 body 标签含 ID

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

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

4、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】）保存修改后的文件。

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

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

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

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

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

二、导致内容出错的问题

有时 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 格式，有时也能解决推送失败的问题。

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

© 「书伴」原创文章，转载请注明出处及原文链接：https://bookfere.com/post/992.html

“推送EPUB”相关阅读

给这篇文章写一条留言

提示：带 * 标记的是必填项。您填写的邮箱地址将会被保密。首次留言将会在通过人工审核后显示。如果是提出问题，请务必提供尽可能多信息，这有助于他人更好地理解你所提出的问题。

小伙伴们写下了 50 条留言

  1. 您好，请问kindle越狱后还可以推送epub版本吗？我的epub文件一直推送失败，谢谢您的回复。

    回复

    • 可以，越狱不影响 Kindle 的原生功能，包括推送 EPUB 文件。推送失败可能是其它原因，你可以尝试本文提供的方法排查问题，或者用 Calibre 重新转换一下 EPUB 格式，看看能不能解决。

      回复

  2. 有人推荐了一个calibre插件用来调整英文电子书符号乱码问题。

    https://blog.the-ebook-reader.com/2022/05/06/how-to-fix-formatting-issues-on-epubs-sent-to-kindles/

    回复

  3. 最近我在使用美亚邮箱推送的时候，在calibre中将epub转换成epub（为了调整行间距）后，推送文件后经常出现丢失目录的情况（原文件目录正常的），不知道大家有没有遇到相同的问题，如何解决呢？

    回复

  4. 现在利用calibre推书的时候书名老是默认变成拼音字母，还会收到亚马逊发来的推送mobi文件政策将有变化的提醒，以前都没试过的，不知道如何解决？

    回复

    • 亚马逊好像会把文件名作为书名，calibre的推送的时候文件名就就拼音，把文件从calibre库中拿出来，改为中文文件名，然后手动邮件附件推送，就能变成中文了

      回复

  6. 请问下，确认epub没问题，但是发到美亚后显示被退回，是什么问题，之前都没问题，现在就是显示，未知的原因，对方拒绝接收您的邮件

    抱歉，您的信件被退回
    尊敬的用户 xxx：
    您发送到 xxx4@kindle.com 的邮件被系统退回，以下是退信相关信息：
    未知的原因，对方拒绝接收您的邮件
    建议解决方案：建议您稍后修改主题或内容重新发信尝试，或与对方邮件服务提供商的服务支持团队联系，反馈该问题。

    回复
返回到顶部