EPUBCheck のエラーの読み方

EPUBCheck は EPUB の規格違反を見つける公式の検査器で、java -jar epubcheck.jar 本.epub で動きます。日本語の環境では結果も日本語で出ますが、メッセージは短く、どこを直せばよいかまでは書かれていません。KDP(Kindle ダイレクト・パブリッシング)に入れる EPUB は EPUBCheck を通すのが前提ですが、Kindle Previewer 4 は EPUBCheck が止めるファイルの多くを「Success・Error Count 0」で通してしまい、逆に EPUBCheck 0 件でも中身を黙って変えることがあります。

この頁は、同じ縦書きの原稿を意図的に壊して EPUBCheck 5.2.1 と Kindle Previewer 4.0.0 の両方にかけた実測(2026 年 10 月〜11 月・計 100 本以上)から、実際に出た 18 本の番号を取り上げます。各項目は「メッセージ(原文)→ 何が起きているか → 直し方 → Previewer はどうするか」の順です。番号は「種類-3 桁」で、RSC は参照・リソース、OPF はパッケージ文書(content.opf)、PKG は zip 容器、NAV は目次文書を指します。

Previewer 側の番号(E21011・W14001 など)から引きたい時は EPUB 入稿前検品の番号表 を見てください。 Previewer の番号ごとに、同じ本を EPUBCheck 5.2.1 に通すと何番で止まるか(止まらず 0 件になる型も明示)を並べた索引は、Zenn 本『縦書きEPUBがKDPプレビューで崩れる7つの原因と直し方』§1(無料)の『Kindle Previewer の番号から引く』13 行にあります。

1. 読み方の 3 つの決まり

2. 本文(XHTML)側で出る番号

RSC-005「ファイル解析時のエラー: Duplicate ID "fn1"」

同じ XHTML の中に同じ id が 2 回あります。脚注を Word から変換した時に fn1 や fnref1 が章ごとに振り直されて重複する形が最も多いです。RSC-005 は「スキーマに合わない」をまとめて指す番号なので、後ろの文で原因を読みます。

RSC-005「要素 "h7" をここに書いてはいけません」

存在しない要素名や、置けない場所に置いた要素です。見出しは h1〜h6 までで、h7 は変換ツールが深い見出しを機械的に作った時に出ます。

RSC-005「要素 "metadata" の内容が不完全です. 以下の必要な要素が書かれていません "dc:language"」

content.opf の <metadata> に <dc:language>ja</dc:language> がありません。

RSC-005「Exactly one manifest item must declare the "nav" property (number of "nav" items: 0)」

論理目次(nav.xhtml・properties="nav")がありません。手書きの目次ページだけでは目次になりません。nav 文書はあるのに epub:type="toc" が無い時は「Exactly one "toc" nav element must be present」になります。この 2 本は日本語訳が無く英語のまま出ます。

RSC-012「フラグメント識別子が定義されていません」

href="chap02.xhtml#fn2" の #fn2 に当たる id が、その飛び先のファイルに無い状態です。脚注の参照と注本体の id がずれた時、Word の name 属性が id に変換されなかった時、同じファイル内なのに href に別のファイル名を書いた時に出ます。

RSC-007「参照されているリソース "OEBPS/fig1.jpg" がEPUB内に見つかりません」

本文の src や href が指すファイルが zip の中にありません。manifest に書いたのに無い場合は RSC-001 で、こちらは本文から参照したのに無い場合です。両方出ることもあります。a href のリンク先の XHTML は、zip にあっても manifest に無ければこの番号になります(画像や CSS なら RSC-008)。

RSC-008「参照されているリソース "OEBPS/fig1.png" がOPF manifest内で宣言されていません」

ファイルは zip の中にあるのに、manifest に item の行が無い形です。図を後から足して manifest を書き忘れた、CSS を 2 本目に増やした、フォントを入れたが manifest に載せなかった、という時に出ます。RSC-007(ファイルそのものが無い)と対になる番号ですが、出るのは img・link・audio など埋め込みの参照だけです。a href のリンク先の XHTML が manifest に無い時は、zip にあっても RSC-007 の方で出ます(EPUBCheck はリンク先を manifest の中からしか探さないため)。

RSC-011「spine項目ではないリソースへの参照が見つかりました」

注をまとめた notes.xhtml などを manifest には載せたのに spine(読み順)に載せていない状態で、本文からそこへリンクしています。

RSC-016「ファイル解析時の致命的なエラー: The prefix "epub" for attribute "epub:type" ... is not bound」

XML として読めません。この原文は epub:type を使っているのに <html> に xmlns:epub="http://www.idpf.org/2007/ops" が無い形です。閉じタグの欠落(</p> 無し)も同じ FATAL になります。

RSC-020「"end notes.xhtml#fn2" は有効なURLではありません」と PKG-010(ファイル名にスペース)

ファイル名に空白があります。href に空白をそのまま書くと RSC-020(ERROR)、%20 に符号化しても PKG-010(WARNING「古いリーダーとの相互運用性に問題」)は残ります。

RSC-028「XML文書はUTF-8でエンコードする必要がありますが、SHIFT_JISが検出されました」

XHTML の先頭宣言が encoding="Shift_JIS" のまま、または実際の文字コードが Shift_JIS です。古い Word やテキストエディタの保存設定で起きます。

RSC-032「外部リソースにはフォールバックが提供されなければなりませんが, タイプ "image/tiff" のリソース ... に対して何も見つかりませんでした」

EPUB が標準で許す画像は JPEG・PNG・GIF・SVG(と WebP)だけです。TIFF・BMP はフォールバック(代替画像)が無いと ERROR です。

3. パッケージ文書(content.opf)で出る番号

OPF-029「ファイル "OEBPS/fig1.png" がOPFファイルで指定されたメディアタイプ image/png と一致していないようです」

拡張子と中身が違います。JPEG の中身を .png に改名した、PNG を .jpg で保存した、フォントに image/png を書いた、などです。フォントの場合は PKG-021「壊れた画像ファイルがありました」も一緒に出ます。

OPF-049「ID "chap3" のアイテムがマニフェストにありません」

spine の idref が manifest に無い id を指しています。章を削った後に spine だけ残った形です。RSC-005・RSC-011 も同時に出ます。

RSC-001「ファイル "OEBPS/chap04.xhtml" が見つかりません」

manifest に書いたファイルが zip の中に無い形です。章を 1 つ消したのに manifest と spine の行を残した、ファイル名の綴りや大文字小文字が manifest と違う、CSS の実体を入れ忘れた、という時に出ます。本文からの参照が無いファイルなら RSC-007 は出ず、この番号だけになります。

OPF-043「非標準のメディアタイプ "text/html" を持ったspine要素はフォールバックできません」

本文ファイルの media-type が application/xhtml+xml ではありません。HTML をそのまま入れた時に出ます。

OPF-014「プロパティ "svg" をOPFで宣言してください」

本文の XHTML にインライン SVG や MathML があるのに、manifest の item に properties="svg"(mathml)が無い状態です。

OPF-003「アイテム "OEBPS/extra.xhtml" がEPUB内に存在しますが、OPFマニフェストで宣言されていません」(-u 指定時のみ)

zip の中にあるのに manifest に載っていないファイルです。既定では表示されず、-u を付けた時に USAGE として出ます。入稿を止める番号ではありませんが、消したつもりの旧版の章や、macOS の Finder が足す .DS_Store が残っている印です。

4. zip 容器で出る番号

PKG-006「mimetypeファイルエントリが存在しないか、アーカイブの先頭以外の場所に存在しています」

EPUB は zip の先頭エントリが mimetype でなければなりません。フォルダを右クリックで圧縮した、zip -r で一括圧縮した、macOS の Finder や ditto で固めた、という時は順番が守られずこの番号になります。__MACOSX フォルダが入っているのも同じ経路の印です。

PKG-007「mimetypeファイルは文字列 "application/epub+zip" だけを含み、また圧縮してはいけません」

mimetype が圧縮(deflate)されている、または末尾に改行や BOM が付いています。

PKG-005「mimetypeファイルに長さ28の拡張フィールドがあります. mimetypeファイルでZIPフォーマットの拡張フィールド属性を使うことは許可されていません」

mimetype は先頭・無圧縮で入っているのに、zip のエントリに更新日時や所有者を記録する「拡張フィールド」が付いています。コマンドの zip を -X 無しで使うとこうなります(zip -0 本.epub mimetype だけだと 28 バイト付く)。中身は正しいので、見落としやすい番号です。

5. 目次文書で出る番号

nav.xhtml の目次項目の並びが、spine の読み順と食い違っています。章の順番を入れ替えた時に nav だけ古いままだと出ます。

6. EPUBCheck が 0 件でも直す物

上の 18 本は EPUBCheck が止めてくれる物です。逆に EPUBCheck 0 件・Previewer 注意ゼロのまま、Kindle 向けの変換で中身が変わる型が別に 10 種あります(link した CSS の実体が無い→素組み、同一ファイル内の重複 id→最初の 1 つに結ぶ、break-before: page だけ→改ページが入らない、text-combine-upright: digits→数字が寝たまま、ルビの入れ子→Enhanced Typesetting が外れる、など)。これは EPUB を開いてブラウザの中だけで照合する EPUB 入稿前検品(無料・インストール不要・ファイルは送信しません) で一覧にできます。両方を通してから入稿すると、Previewer の画面を 1 ページずつ見る時間を減らせます。

同じ原稿を 600 本以上に振って Previewer と EPUBCheck にかけたログ、縦書き 3 点セット、Word 原稿側の崩れ所、脚注の 66 通りの実測は Zenn 本『縦書きEPUBがKDPプレビューで崩れる7つの原因と直し方』(§1 の症状→原因→直し方の対応表は無料)にまとめています。

関連する説明頁