推送 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 元素有误”。

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

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

一、导致推送失败的问题

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

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

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

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

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

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

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

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

二、导致内容出错的问题

1、电子书内容出现乱码

2、电子书目录层级有误

3、电子书导航目录缺失

4、电子书字体显示异常

发表评论取消回复

一条评论 “推送 EPUB 文件到 KINDLE 的常见失败原因及解决方法”

一、导致推送失败的问题

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

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

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

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

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

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

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

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

二、导致内容出错的问题

1、电子书内容出现乱码

2、电子书目录层级有误

3、电子书导航目录缺失

4、电子书字体显示异常

发表评论 取消回复

一条评论 “推送 EPUB 文件到 KINDLE 的常见失败原因及解决方法”

发表评论取消回复