インポート・移行でハマりやすいポイント

インポート・移行でハマりやすいポイント

Notion / Confluence / Markdown 等からの インポート・移行 でよくある問題と対処です。

こんなときに読む

インポートが途中で止まる・失敗する
画像やリンクが壊れている
Confluence / DOCX が選べない

事前確認

項目	内容
エディション	Confluence・DOCX・PDF は Enterprise（No.7.5・No.2.8）
権限	Space でインポート権限（Writer 以上等）
サイズ	単一ファイル 30MB、ZIP は画面上限を確認
ライセンス	EE 機能は No.10.5 で有効化

よくある問題と対処

1. インポートボタンが無い・グレーアウト

Space メニュー（...）> Import pages の場所を確認
Enterprise フォーマットはライセンスと Space ロールを確認
Private Space に参加しているか

2. ZIP 処理が終わらない

タブを閉じない（大容量 ZIP はバックグラウンド処理）
通知パネルで進捗・完了を待つ
サーバーのディスク・メモリ・タイムアウト（リバースプロキシ）を確認

3. 画像が表示されない

原因	対処
Notion エクスポートに画像が含まれていない	Notion 側で「含める」オプションで再エクスポート
相対パスが壊れている	ZIP 内の `files/` 構造を維持したまま再インポート
外部 URL のみ	元 URL が有効か、または手動で再アップロード
ストレージ設定ミス	`STORAGE_DRIVER` と保存先（No.10.3）

4. 階層・ページ名がおかしい

インポート後に D&D でツリー整理（No.4.7）
Notion の「サブページ」がフラットになる場合は手動で親子付け
重複タイトルはスラッグで区別されることがある

5. 表・コードブロック・数式の崩れ

ソースと Docmost エディタの表現差による 仕様上の限界 のことが多い
重要ページはインポート後に spot check と手直し
Confluence マクロは変換されない場合がある

6. 文字化け

元ファイルのエンコーディング（UTF-8 推奨）
ZIP 内の HTML の <meta charset> を確認

7. Confluence だけ失敗する

Enterprise ライセンスが Active か
Confluence の 公式スペースエクスポート ZIP 形式か
添付が多い場合は分割エクスポートを検討

移行プロジェクトの進め方

パイロット Space で小さな ZIP を試す
画像・表・リンクのサンプルページをチェックリスト化
本番移行はメンテナンス枠を取る
旧環境は一定期間 読み取り専用で保持（ロールバック用）

関連ナレッジ

インポート手順: 「インポート — Markdown / Notion / Confluence 等」（No.7.5）
ページ整理: 「ページの移動・複製・ゴミ箱」（No.4.7）
ストレージ: 「ストレージ — local / S3 / Azure」（No.10.3）
FAQ 入口: 「よくある質問」（No.11.1）