← DMARC Analysis Assistant

Chapter 8: トラブルシューティング

Chapter 8: Troubleshooting

← 前章: 6 分類の読み方 目次へ戻る →

トラブルシューティング

起動や取込で問題が発生した場合の対処方法をまとめます。ここに記載のない症状については サポート・FAQ もご確認ください。

起動関連

アプリが起動しない / 白い画面のまま

  • 原因候補: Microsoft Edge WebView2 Runtime が不足。
  • 対処: Microsoft 公式サイトから WebView2 Runtime（Evergreen Bootstrapper）を導入。Windows 11 は通常プリインストール済み。

起動直後に「利用規約・免責事項」画面が毎回表示される

  • 原因候補: ユーザーデータフォルダの書き込み権限不足、または規約改訂。
  • 対処: 規約改訂時は再同意が必要です（改訂版の公開履歴あり）。それ以外の場合は %LocalAppData%\DmarcAnalysisAssistant の書き込み権限を確認。

レポート取込関連

「取込」を押しても 0 件と表示される

  • 原因候補: フォルダ内に DMARC 集約レポート（XML / ZIP / GZ）が存在しない。別種のメールを誤指定。
  • 対処: ZIP / GZ 添付ファイルをフォルダに保存し直して再試行。ファイル名に dmarc または rua を含む場合が多い。

取込時に「XML 解析エラー」

  • 原因候補: レポートの破損、文字コード不整合、非標準スキーマ。
  • 対処: 対象ファイルを除外して再取込。該当ファイルのプロバイダ・ファイル名を控えてサポートまでご連絡ください。

取込に極端に時間がかかる

  • 原因候補: フォルダ内のファイル数が数千件規模、または大容量 ZIP。
  • 対処: 月別にサブフォルダへ分割して取り込む。バックグラウンドスキャンは 1 回の取込に閉じているため、フォルダを分けると段階的に進められます。

取り込んだ件数が実際より少ない（v1.0.5 以前）

  • 原因候補: v1.0.5 以前では、RFC 9990 形式（名前空間付き）の DMARC レポートが読み込めない場合や、内容が似ている別々のレコードが 1 件にまとめられて保存されない不具合がありました。
  • 対処: v1.0.6 で修正済みです。アプリを最新版に更新し、対象のレポートを再度取り込んでください。同じレポートを再度取り込むと、確認なしで自動的に最新の内容へ置き換わります。

バウンス突合関連

「バウンス」ラベルが 1 件もつかない

  • 原因候補: バウンスフォルダが未指定、またはバウンスメールの件名が非標準。
  • 対処: バウンスフォルダを明示的に指定。ISP によっては多言語件名の場合があり、未対応の可能性あり。

Microsoft 365 連携関連

サインインに失敗する

  • 原因候補: テナントの条件付きアクセスでブロック、Mail.Read 権限の同意がまだ、ネットワーク未接続。
  • 対処: 管理者にアプリの同意可否を確認。個人アカウントでも動作しますが、組織アカウントでは管理者同意が必要な場合があります。

サインインは通るがメールが取れない

  • 原因候補: Mail.Read が付与されていない、対象フォルダが空。
  • 対処: 別クライアントでメールの存在を確認。権限スコープは Mail.Read（読み取り専用）のみ使用します。

CSV エクスポート関連

Excel で開くと文字化け

  • 原因候補: Excel の既定エンコーディング。
  • 対処: 本ツールの CSV は UTF-8 BOM 付きで出力します。Excel 365 は通常そのまま読めます。古い Excel では「データの取得 > テキスト」で UTF-8 を指定してください。

データ保存先とリセット

本ツールはユーザーデータを %LocalAppData%\DmarcAnalysisAssistant 配下に保存します。v1.0.5 以降では、DMARC の保存済み解析結果が残っている場合、設定画面の「保存済みDMARC解析データを削除」から削除できます。この操作では、設定情報、同意情報、管理区分メモ、バウンス分析データは削除されません。Microsoft 365 の認証トークンはメモリ上のみで、ディスクには保存されません。

それでも解決しない場合

Troubleshooting

Common issues and how to resolve them. If your issue is not listed here, see Support & FAQ.

Launch issues

The app does not start / stays on a blank screen

  • Likely cause: Microsoft Edge WebView2 Runtime is missing.
  • Fix: Install the WebView2 Runtime (Evergreen Bootstrapper) from Microsoft's official site. It is typically pre-installed on Windows 11.

The Terms of Use screen appears on every launch

  • Likely cause: Lack of write permission to user data folder, or a terms revision.
  • Fix: Re-consent is required after a terms revision (version history is published). Otherwise, check write permission on %LocalAppData%\DmarcAnalysisAssistant.

Report import issues

Import returns 0 rows

  • Likely cause: The folder contains no DMARC aggregate reports (XML / ZIP / GZ), or the wrong folder was selected.
  • Fix: Save ZIP / GZ attachments into the folder and retry. Filenames commonly contain dmarc or rua.

"XML parse error" during import

  • Likely cause: Corrupted report, encoding mismatch, or nonstandard schema.
  • Fix: Move the offending file aside and retry. Please report the provider and filename to support.

Import is extremely slow

  • Likely cause: Thousands of files in one folder, or very large ZIPs.
  • Fix: Split by month into subfolders. Scanning is scoped to a single import run, so splitting folders lets you progress incrementally.

Imported record count is lower than expected (v1.0.5 and earlier)

  • Likely cause: In v1.0.5 and earlier, RFC 9990 namespace-qualified DMARC reports could fail to parse, and distinct records with similar content could be collapsed into a single saved record.
  • Fix: Fixed in v1.0.6. Update the app and re-import the affected reports. Re-importing an already-imported report automatically replaces the saved content with the latest parse, with no confirmation step.

Bounce correlation

No entry is labeled "Bounce"

  • Likely cause: Bounce folder not specified, or bounce subjects are nonstandard.
  • Fix: Specify the bounce folder explicitly. Some ISPs use localized subject lines that may be unsupported.

Microsoft 365 integration

Sign-in fails

  • Likely cause: Conditional access policy, Mail.Read not consented, or no network.
  • Fix: Ask your admin whether app consent is permitted. Personal accounts work as well; organizational accounts may require admin consent.

Sign-in succeeds but no mail is retrieved

  • Likely cause: Mail.Read not granted, or the target folder is empty.
  • Fix: Verify the messages exist via another client. This tool only uses the Mail.Read scope (read-only).

CSV export

Garbled characters in Excel

  • Likely cause: Excel default encoding.
  • Fix: Our CSV is UTF-8 with BOM. Excel 365 reads it as-is. In older Excel, use "Get Data > From Text" and specify UTF-8.

Data location and reset

User data is stored under %LocalAppData%\DmarcAnalysisAssistant. In v1.0.5 and later, if saved DMARC analysis results remain, open Settings and use "Delete stored DMARC analysis data" to delete them. This action does not delete settings, consent information, management notes, or bounce analysis data. Microsoft 365 authentication tokens are held in memory only and never persisted.

Still stuck?

© 2026 Sumikko Lab. DMARC Analysis Assistant.