QGISで問題が発生したとき、原因を特定して解決する方法をまとめました。
QGISトラブルシューティング【よくある問題と解決策】
起動・動作の問題
QGISが起動しない
症状
アイコンをクリックしても何も起きない
対処
- 管理者として実行 → アイコンを右クリック → 「管理者として実行」
- セキュリティソフトを確認 → 一時的に無効化して再試行
- ユーザープロファイルをリセット → プロファイルフォルダをリネーム（Windows: %APPDATA%\QGIS\QGIS3\profiles）
- 再インストール → アンインストール後、最新版をインストール
起動が非常に遅い
症状
起動に数分かかる
対処
- プラグインを無効化して起動 → コマンドラインから: qgis –noplugins
- 問題のあるプラグインを特定 → 1つずつ有効化して確認
- ネットワーク接続を確認 → オフラインで起動を試す
- プロファイルをリセット
QGISがフリーズする
症状
操作中に応答しなくなる
対処
- 大きなデータを扱っている場合 → データを分割、空間インデックスを作成、GeoPackageに変換
- 特定の操作でフリーズする場合 → その操作を避ける回避策を検討、バグ報告
- メモリ不足の場合 → 不要なレイヤを削除、他のアプリケーションを終了
表示の問題
レイヤが表示されない
症状
レイヤを追加したが地図上に何も表示されない
対処
- レイヤの表示チェックを確認 → レイヤパネルでチェックボックスを確認
- 表示範囲の問題 → レイヤを右クリック → 「レイヤの領域にズーム」
- 座標系の問題 → プロジェクトCRSとレイヤCRSを確認、オンザフライ変換が有効か確認
- シンボロジの問題 → シンボルの色・サイズを確認、透明度が100%になっていないか
位置がずれる
症状
異なるレイヤの位置が合わない
対処
- 座標系を確認 → 各レイヤのCRSを確認、同じCRSに統一
- 元データの座標系が正しいか確認 → .prjファイルの内容、メタデータ
- 座標系の再設定 → レイヤプロパティ → ソース → CRSを設定
- 座標変換して保存 → エクスポート → 新規ファイルに保存 → 正しいCRSを指定
文字化け
症状
属性やラベルが文字化けする
対処
- エンコーディングを変更 → レイヤプロパティ → ソース → エンコーディング: UTF-8 または Shift_JIS
- CPGファイルを作成 → シェープファイルと同名の.cpgファイル、内容: UTF-8
- データを変換して保存 → UTF-8でエクスポート
表示が遅い
症状
ズーム・パンがカクつく
対処
- 空間インデックスを作成
- 縮尺に応じた表示を設定 → 小縮尺では表示しない
- シンボル・ラベルを簡素化
- レンダリングキャッシュを有効化 → 設定 → オプション → レンダリング
- GeoPackageに変換
データ読み込みの問題
ファイルが開けない
症状
レイヤの追加で「無効なレイヤ」
対処
- ファイルパスを確認 → 日本語パスを避ける、スペースを避ける
- ファイルが破損していないか確認 → 他のソフトで開けるか
- 必要なファイルが揃っているか確認 → シェープファイル: .shp, .shx, .dbf
- ドライバを確認 → 対応形式か確認
DWG/DXFが読み込めない
症状
CADファイルが読み込めない
対処
- DXF形式に変換 → CADソフトでDXFにエクスポート、ODA File Converter（無料）を使用
- バージョンを下げる → AutoCAD 2000形式でエクスポート
- 座標系を手動設定 → 読み込み後にCRSを設定
CSV/Excelが読み込めない
症状
CSVが点データとして読み込めない
対処
- 座標列を確認 → 緯度/経度の列が正しいか、数値形式になっているか
- 区切り文字を確認 → カンマ区切りか確認
- エンコーディングを確認 → UTF-8で保存
- ヘッダー行を確認 → 1行目がヘッダーか
処理・分析の問題
処理ツールがエラー
症状
処理を実行するとエラーメッセージ
対処
- エラーメッセージを確認 → 具体的な原因が書かれている場合が多い
- 入力データを確認 → 無効なジオメトリがないか、空のフィーチャがないか
- パラメータを確認 → 単位は正しいか、値の範囲は適切か
- 別の方法を試す → 同等の機能を持つ別のツール
ジオメトリエラー
症状
「無効なジオメトリ」エラー
対処
- ジオメトリの妥当性を確認 → ベクタ → ジオメトリツール → 妥当性チェック
- ジオメトリを修復 → ベクタ → ジオメトリツール → ジオメトリの修正
- バッファ処理で修復 → バッファ距離0で処理
処理結果がおかしい
症状
期待と異なる結果になる
対処
- 座標系を確認 → 投影座標系で処理しているか、単位（メートル vs 度）
- 入力データを確認 → 期待するデータが入っているか
- パラメータを確認 → 設定値は正しいか
出力の問題
印刷がおかしい
症状
印刷結果が画面と異なる
対処
- 解像度を確認 → 印刷レイアウト → ページ設定 → 出力解像度
- フォントを確認 → インストールされているフォントか
- シンボルサイズを確認 → 印刷時のサイズを確認
- PDF経由で印刷 → まずPDFにエクスポート → PDFを印刷
エクスポートできない
症状
ファイル出力でエラー
対処
- 出力先を確認 → 書き込み権限があるか、空き容量があるか
- ファイル名を確認 → 使用できない文字がないか
- 形式を確認 → 対応形式か、ドライバがインストールされているか
プラグインの問題
プラグインが動かない
症状
プラグインでエラーが発生
対処
- プラグインを更新 → プラグイン管理画面で「更新可能」を確認
- QGISのバージョンを確認 → プラグインの対応バージョンか
- プラグインを再インストール → 削除 → 再インストール
- 依存関係を確認 → 必要なライブラリがあるか
プラグインがインストールできない
症状
インストールボタンが押せない、エラー
対処
- ネットワーク接続を確認
- プロキシ設定を確認 → 設定 → オプション → ネットワーク
- 手動インストール → ZIPをダウンロード → プラグインフォルダに展開
情報収集とサポート
ログの確認
ビュー → パネル → ログメッセージ → 詳細なエラー情報を確認
バージョン情報の確認
ヘルプ → QGISについて → QGISバージョン、OSなどを確認
情報収集先
| 情報源 | 内容 |
|---|---|
| QGIS公式ドキュメント | 公式マニュアル |
| QGIS Japan | 日本語コミュニティ |
| GIS Stack Exchange | Q&Aサイト |
| GitHub Issues | バグ報告・機能要望 |
バグ報告
報告時のポイント
- 再現手順を明確に
- バージョン情報を含める
- エラーメッセージを全文
- サンプルデータがあれば添付
- 報告先: https://github.com/qgis/QGIS/issues
まとめ
トラブル解決の基本
基本ステップ
- エラーメッセージを読む
- 座標系を確認する
- データを確認する
- シンプルな状態で再現する
- 検索・質問する
よくある原因
原因ランキング
- 1位: 座標系の問題
- 2位: データの問題（破損、形式）
- 3位: パスの問題（日本語、長すぎる）
- 4位: メモリ・パフォーマンスの問題
- 5位: プラグインの問題
関連記事