【トラブルシューティング入門 #1】エラー文でググる

PythonのWEBアプリケーションフレームワークを使っていたところ、次のようなエラーが発生しました。

エラーの内容：

django.core.management.base.SystemCheckError: SystemCheckError: System check identified some issues:

ERRORS:
auth.User.groups: (fields.E304) Reverse accessor for 'User.groups' clashes with reverse accessor for 'User.groups'.
        HINT: Add or change a related_name argument to the definition for 'User.groups' or 'User.groups'.
auth.User.user_permissions: (fields.E304) Reverse accessor for 'User.user_permissions' clashes with reverse accessor for 'User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'User.user_permissions' or 'User.user_permissions'.
mocrat_user.User.groups: (fields.E304) Reverse accessor for 'User.groups' clashes with reverse accessor for 'User.groups'.
        HINT: Add or change a related_name argument to the definition for 'User.groups' or 'User.groups'.
mocrat_user.User.user_permissions: (fields.E304) Reverse accessor for 'User.user_permissions' clashes with reverse accessor for 'User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'User.user_permissions' or 'User.user_permissions'.

System check identified 4 issues (0 silenced).

結論としては非常に初歩的な内容で、カスタムユーザを設定していたのにSettingsにAUTH_USER_MODELを設定し忘れていたよ、って話でした。

ちなみに解消方法は、Settings.pyに以下の一文を追記するだけです。

AUTH_USER_MODEL = 'AppName.ClassName'

ところで、このエラーはトラブルシューティングの初歩について説明する上でちょうどいいサンプルでしたので、本記事ではこの事例を利用してトラブルシューティングの基本的なやり方について解説していきます。

エラーが発生した場合の初歩的なググり方や考え方についてまとめていきます。

余談ですが、Google検索で必要な情報を得るコツについては、こちらの記事でもまとめているので、良ければご覧ください。

まずはエラー文を読む

さて、トラブルシューティングの初歩ですが、まずは嫌がらずにエラー文を読みましょう。

コンパイラやインタプリタは非常に賢いので、ちょっとした問題であれば、エラー文を読むだけで解消するケースが多いです。
例えば、Pythonの文法エラーの場合、次のような出力が確認できます。

>>> print(100 + "Hello")
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: unsupported operand type(s) for +: 'int' and 'str'

まず、Tracebackの直下に、エラーの原因となった場所が示されていますね。
この例の場合は、1行目に問題があるようです。

次に、エラーの理由が書かれています。

TypeError: unsupported operand type(s) for +: 'int' and 'str'
とあるので、どうやらint型とstr型の加算はサポートされていないとのことです。

この例の場合であれば、これを読めば100をクオテーションで囲い忘れていたことがエラーの原因だということがわかりましたね。

エラー文でググる

では、冒頭で引用したエラー文をもう一度見てみます。

色々書いてありますが、エラーの原因となるファイルの名前や行数については書いてありません。

また、原因に関連しそうな記載として、SystemCheckError: System check identified some issues とありますが、なんのことかよくわかりません。

エラーの内容：

django.core.management.base.SystemCheckError: SystemCheckError: System check identified some issues:

ERRORS:
auth.User.groups: (fields.E304) Reverse accessor for 'User.groups' clashes with reverse accessor for 'User.groups'.
        HINT: Add or change a related_name argument to the definition for 'User.groups' or 'User.groups'.
auth.User.user_permissions: (fields.E304) Reverse accessor for 'User.user_permissions' clashes with reverse accessor for 'User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'User.user_permissions' or 'User.user_permissions'.
mocrat_user.User.groups: (fields.E304) Reverse accessor for 'User.groups' clashes with reverse accessor for 'User.groups'.
        HINT: Add or change a related_name argument to the definition for 'User.groups' or 'User.groups'.
mocrat_user.User.user_permissions: (fields.E304) Reverse accessor for 'User.user_permissions' clashes with reverse accessor for 'User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'User.user_permissions' or 'User.user_permissions'.

System check identified 4 issues (0 silenced).

そんな時は、エラー文をコピペしてググってあげましょう。

その場合は、全文コピペすると上手く検索できないので、1文くらいに絞って検索します。

また、その際、自作のファイル名などが入っていない部分を使用するようにしましょう。

今回のケースでは、"mocrat_user"というのが自作のファイル名なので、その部分は検索に含めないようにします。
これは、自作のファイル名が検索ワードに含まれていると、それがノイズになって、期待する検索結果が得られない場合があるためです。

では検索をしていきます。

まず、SystemCheckError: System check identified some issues でググってみました。

まずは上位3記事を開いてみましょう。

すると、内容が見事にバラバラでした。

1記事目は、MEDIA_URLの設定に失敗してSystemCheckErrorが出力されており、2記事目はadmin.pyの設定漏れ、最後はmigrationの仕組みについての記事でした。

ここから考えられることとして、どうやらSystemCheckErrorは特定の事象ではなく、エラーに対して汎用的に用いられる出力ということが予想できます。