{"title":"システムチェックフレームワーク","version":"5.1","locale":"ja","docname":"ref/checks","url":"/ja/5.1/ref/checks/","canonical":"https://djangodocs.dev/ja/5.1/ref/checks/","summary":"システムチェックフレームワークは、Django プロジェクトを検証するための静的チェックのセットです。一般的な問題を検出し、それらを修正するヒントを提供します。このフレームワークは拡張性があり、独自のチェックを簡単に追加できます。 独自のチェックを追加し、Django のシステムチェックと統合する方法については、…","html":"

システムチェックフレームワークLink to this heading#

\n

システムチェックフレームワークは、Django プロジェクトを検証するための静的チェックのセットです。一般的な問題を検出し、それらを修正するヒントを提供します。このフレームワークは拡張性があり、独自のチェックを簡単に追加できます。

\n

独自のチェックを追加し、Django のシステムチェックと統合する方法については、 システムチェックのトピックガイド を参照してください。

\n
\n

API リファレンスLink to this heading#

\n
\n

CheckMessageLink to this heading#

\n
\n
\nclass CheckMessage(level, msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n

システムチェックで発生する警告やエラーは CheckMessage のインスタンスでなければなりません。インスタンスは1つの報告可能なエラーや警告をカプセル化します。また、メッセージに適用されるコンテキストとヒント、フィルタリングに使用される一意の識別子も提供します。

\n

コンストラクタの引数は以下の通りです：

\n
\n
level

メッセージの重大度。定義済みの値、 debug、 info、 warning、 error、 critical のいずれかを使用します。レベルが ERROR 以上の場合、Django は管理コマンドの実行を抑止します。レベルが ERROR より低いメッセージ (つまり警告) はコンソールに報告されますが、抑制することもできます。

\n
\n
msg

問題を説明する短い (80 文字未満) 文字列。文字列には改行を含めてはいけません。

\n
\n
hint

問題を解決するためのヒントを示す1行の文字列。ヒントを提供できない場合、またはヒントがエラーメッセージから明らかな場合は、ヒントを省略するか、 None を使用できます。

\n
\n
obj

オプション。メッセージのコンテキストを提供するオブジェクト (例えば、問題が発見されたモデル)。オブジェクトはモデル、フィールド、マネージャ、または __str__() メソッドを定義する他のオブジェクトでなければなりません。このメソッドはすべてのメッセージを報告するときに使用され、その結果はメッセージの前に置かれます。

\n
\n
id

オプションの文字列。issueの一意な識別子。識別子は applabel.X001 というパターンに従うべきです。ここで X はメッセージの重大度を示す文字 CEWID のいずれかです（クリティカルは C、エラーは E など）。この番号はアプリケーションによって割り当てることができますが、アプリケーション内で一意である必要があります。

\n
\n
\n

共通のレベルを持つメッセージを簡単に作成するためのサブクラスがあります。これらを使用する場合、引数 level は省略できます。

\n
\n
\nclass Debug(msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n
\n
\nclass Info(msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n
\n
\nclass Warning(msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n
\n
\nclass Error(msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n
\n
\nclass Critical(msg, hint=None, obj=None, id=None)Link to this definition#
\n
\n\n
\n
\n
\n

組み込みタグLink to this heading#

\n

Django のシステムチェックは、以下のタグを使って整理されています：

\n\n

いくつかのチェックは複数のタグで登録されていれる可能性があります。

\n
\n
\n

コアシステムチェックLink to this heading#

\n
\n

非同期サポートLink to this heading#

\n

以下のチェックは、非同期サポート のセットアップを検証します。

\n\n
\n
\n

後方互換性Link to this heading#

\n

互換性チェックは、Django をアップグレードした後に起こりうる問題を警告します。

\n\n
\n
\n

キャッシュLink to this heading#

\n

以下のチェックでは、CACHES 設定が正しく構成されていることを確認します：

\n\n
\n
\n

データベースLink to this heading#

\n
\n

MySQL と MariaDBLink to this heading#

\n

MySQLまたはMariaDBを使用している場合、以下のチェックが行われます：

\n
    \n

  • mysql.E001: MySQL/MariaDB では、ユニークな CharField の max_length を 255 より大きくすることはできません。このチェックは、実際の最大サイズが多くの要因に依存するため、Django 3.1 では mysql.W003 に変更されました。

    • \n

  • mysql.W002: MySQL/MariaDB Strict Mode がデータベース接続 <alias> に設定されていません。 sql_mode の設定 も参照してください。

    • \n

  • mysql.W003: MySQL/MariaDBでは、一意な CharField の max_length が255を超えることが許可されていない場合があります。

    • \n
\n
\n
\n
\n

ファイルの管理Link to this heading#

\n

次のチェックは、 ファイルの管理 の設定を検証します。

\n\n
\n
\n

モデルフィールドLink to this heading#

\n\n
\n

ファイルフィールドLink to this heading#

\n
    \n

  • fields.E200: unique は FileField の有効な引数ではありません。 このチェックは Django 1.11 で削除されました 。

    • \n

  • fields.E201: primary_key は FileField に対して有効な引数ではありません。

    • \n

  • fields.E202: FileField の upload_to 引数は絶対パスではなく、相対パスでなければなりません。

    • \n

  • fields.E210: Pillow がインストールされていないため、ImageField を使用できません。

    • \n
\n
\n
\n

関連フィールドLink to this heading#

\n
    \n

  • fields.E300: フィールドはモデル <model> とのリレーションを定義していますが、そのモデルはインストールされていないか、抽象です。

    • \n

  • fields.E301: フィールドは、スワップアウトされたモデル <app_label>.<model> とのリレーションを定義しています。

    • \n

  • fields.E302: <app_label>.<model>.<field name> の逆アクセサ <related model>.<accessor name> はフィールド名 <app_label>.<model>.<field name> と衝突します。

    • \n

  • fields.E303: <app_label>.<model>.<field name> の逆引きクエリ名が <app_label>.<model>.<field name> のフィールド名と衝突しています。

    • \n

  • fields.E304: 逆アクセサ <related model>.<accessor name> が <app_label>.<model>.<field name> の逆アクセサと衝突しています。

    • \n

  • fields.E305: <app_label>.<model>.<field name> の逆引きクエリ名が <app_label>.<model>.<field name> の逆引きクエリ名と衝突しました。

    • \n

  • fields.E306: 名前 <name> はフィールド <model>.<field name> の related_name として無効です。

    • \n

  • fields.E307: フィールド <app label>.<model>.<field name> は <app label>.<model> への遅延参照で宣言されましたが、アプリ <app label> がインストールされていないか、モデル <model> を提供していません。

    • \n

  • fields.E308: 逆引きクエリ名 <related query name> はアンダースコアで終わってはいけません。

    • \n

  • fields.E309: 逆向きクエリ名 <related query name> には '__' を含めることはできません。

    • \n

  • fields.E310: モデル <model> におけるフィールド <field1>, <field2>, ... のいずれのサブセットも一意ではありません。

    • \n

  • fields.E311: <model>.<field name> は ForeignKey によって参照されているため、一意でなければなりません。

    • \n

  • fields.E312: リレーション先モデル <app label>.<model> に存在しない to_field <field name> です。

    • \n

  • fields.E320: フィールドは on_delete=SET_NULL を指定していますが、null にはできません。

    • \n

  • fields.E321: フィールドには on_delete=SET_DEFAULT が指定されていますが、デフォルト値がありません。

    • \n

  • fields.E330: ManyToManyField をユニークにすることはできません。

    • \n

  • fields.E331: フィールドは、インストールされていないモデル <model> を介した多対多のリレーションを指定しています。

    • \n

  • fields.E332: 中間テーブルを持つ多対多のフィールドは対称であってはいけません。 このチェックは Django 3.0. 以前にもありました。

    • \n

  • fields.E333: このモデルは <model> の中間モデルとして使われますが、 <model> への外部キーが 2 つ以上あり、曖昧です。キーワード引数 through_fields を使って、 Django がどの外部キーを使うかを指定しなければなりません。

    • \n

  • fields.E334: このモデルは <model> によって中間モデルとして使われますが、 <model> からの外部キーが複数あり、曖昧です。キーワード引数 through_fields を使って、 Django がどの外部キーを使うかを指定する必要があります。

    • \n

  • fields.E335: このモデルは <model> の中間モデルとして使われていますが、 <model> への外部キーが複数あり、曖昧です。キーワード引数 through_fields を使って、 Django がどの外部キーを使うかを指定する必要があります。

    • \n

  • fields.E336: モデルは <model> の中間モデルとして使用されていますが、 <model> または <model> への外部キーを持っていません。

    • \n

  • fields.E337: フィールドは through_fields を指定していますが、<model> を介したリレーションに使用する 2 つのリンクフィールドの名前を指定していません。

    • \n

  • fields.E338: 中間モデル <through model> に <field name> というフィールドがありません。

    • \n

  • fields.E339: <model>.<field name> は <model> の外部キーではありません。

    • \n

  • fields.E340: フィールドの中間テーブル <table name> が、 <model>/<model>.<field name> のテーブル名と衝突しています。

    • \n

  • fields.W340: null は ManyToManyField には影響しません。

    • \n

  • fields.W341: ManyToManyField は validators をサポートしていません。

    • \n

  • fields.W342: ForeignKey に unique=True を設定すると、OneToOneField を使用したのと同じ効果があります。

    • \n

  • fields.W343: limit_choices_to は through モデルを持つ ManyToManyField には影響しません。 このチェックは Django 4.0 より前に登場しました。

    • \n

  • fields.W344: フィールドの中間テーブル <table name> が <model>/<model>.<field name> のテーブル名と衝突しています。

    • \n

  • fields.W345: related_name は、"self" のような対称なリレーションシップを持つ ManyToManyField に対しては効果がありません。

    • \n

  • fields.W346: db_comment は ManyToManyField に影響を与えません。

    • \n
\n
\n
\n
\n

モデルLink to this heading#

\n\n
\n
\n

セキュリティLink to this heading#

\n

セキュリティチェックはサイトを安全にするものではありません。コードの監査や侵入検知など、特に複雑な処理も行いません。その代わり、自動化された、簡単なチェックリストを実行して、サイトのセキュリティを向上させるのに役立ちます。

\n

これらのチェックの中には、特定のデプロイメント構成に適切でないものもあるかもしれません。たとえば、HTTPからHTTPSへのリダイレクトをロードバランサーで行っている場合、 SECURE_SSL_REDIRECT が有効になっていないと常に警告されるのはイライラするでしょう。 SILENCED_SYSTEM_CHECKS を使って、不要なチェックを行わないようにしましょう。

\n

check --deploy オプションを使用すると、以下のチェックが実行されます:

\n\n

以下のチェックは、セキュリティ関連の設定が正しく構成されているかを確認します:

\n\n
\n
\n

シグナルLink to this heading#

\n\n
\n
\n

テンプレートLink to this heading#

\n

以下のチェックは、TEMPLATES 設定が正しく構成されているかどうかを確認します。

\n\n
\n
\n

翻訳Link to this heading#

\n

以下のチェックが翻訳の設定に対して実行されます:

\n\n
\n
\n

URLLink to this heading#

\n

以下のチェックがURL設定に対して実行されます:

\n\n
\n
\n
\n

contrib アプリのチェックLink to this heading#

\n
\n

adminLink to this heading#

\n

admin チェックはすべて admin タグの一部として実行されます。

\n

管理サイトに登録されている ModelAdmin (またはサブクラス) に対して、以下のチェックが実行されます:

\n\n
\n

ModelAdminLink to this heading#

\n

管理サイトに登録されている ModelAdmin には、以下のチェックが行われます:

\n
    \n

  • admin.E101: save_as の値は真偽値でなければなりません。

    • \n

  • admin.E102: save_on_top の値は真偽値でなければなりません。

    • \n

  • admin.E103: inlines の値はリストかタプルでなければなりません。

    • \n

  • admin.E104: <InlineModelAdmin class> は InlineModelAdmin から継承する必要があります。

    • \n

  • admin.E105: <InlineModelAdmin class> には model 属性が必要です。

    • \n

  • admin.E106: <InlineModelAdmin class>.model の値は Model 型でなければなりません。

    • \n

  • admin.E107: list_display の値は、リストまたはタプルでなければなりません。

    • \n

  • admin.E108: list_display[n] の値が <label> を参照していますが、これは <ModelAdmin class> の呼び出し可能なオブジェクトや属性、または <model> の属性、メソッド、フィールドではありません。

    • \n

  • admin.E109: list_display[n] の値は、多対多のフィールドや逆参照外部キーであってはいけません。

    • \n

  • admin.E110: list_display_links の値は、リスト、タプル、または None のいずれかでなければなりません。

    • \n

  • admin.E111: list_display_links[n] の値が <label> を参照していますが、list_display で定義されていません。

    • \n

  • admin.E112: list_filter の値はリストまたはタプルでなければなりません。

    • \n

  • admin.E113: list_filter[n] の値は ListFilter を継承している必要があります。

    • \n

  • admin.E114: list_filter[n] の値は FieldListFilter を継承してはいけません。

    • \n

  • admin.E115: list_filter[n][1] の値は FieldListFilter を継承する必要があります。

    • \n

  • admin.E116: list_filter[n] の値は <label> を参照していますが、Field を参照していません。

    • \n

  • admin.E117: list_select_related の値は真偽値、タプル、またはリストでなければなりません。

    • \n

  • admin.E118: list_per_page の値は整数でなければなりません。

    • \n

  • admin.E119: list_max_show_all の値は整数でなければなりません。

    • \n

  • admin.E120: list_editable の値はリストまたはタプルでなければなりません。

    • \n

  • admin.E121: list_editable[n] の値は <model> のフィールドではない <label> を参照しています。

    • \n

  • admin.E122: list_editable[n] の値は <label> を参照しており、list_display には含まれていません。

    • \n

  • admin.E123: list_editable[n] の値を list_editable と list_display_links の両方に入れることはできません。

    • \n

  • admin.E124: list_editable[n] の値は list_display の最初のフィールド (<label>) を参照していますが、list_display_links が設定されていないと使用できません。

    • \n

  • admin.E125: list_editable[n] の値は <field name> を参照しており、これは admin を通じて編集できません。

    • \n

  • admin.E126: search_fields の値はリストまたはタプルでなければいけません。

    • \n

  • admin.E127: date_hierarchy の値は <field name> を参照していますが、Field を参照していません。

    • \n

  • admin.E128: date_hierarchy の値は DateField または DateTimeField でなければなりません。

    • \n

  • admin.E129: <modeladmin> は <action> アクションのために has_<foo>_permission() メソッドを定義する必要があります。

    • \n

  • admin.E130: <modeladmin> で定義されたアクションの __name__ 属性は一意でなければなりません。名前 <name> は一意ではありません。

    • \n
\n
\n
\n

InlineModelAdminLink to this heading#

\n

以下のチェックは ModelAdmin のインラインとして登録された InlineModelAdmin に対して行われます。

\n
    \n

  • admin.E201: フィールド <field name> を除外できません。それは親モデル <app_label>.<model> の外部キーです。

    • \n

  • admin.E202: <model> は <parent model> への ForeignKey を持っていません。/ <model> は <parent model> へ複数の ForeignKey を持っています。 fk_name 属性を指定する必要があります。

    • \n

  • admin.E203: extra の値は整数でなければなりません。

    • \n

  • admin.E204: max_num の値は整数でなければなりません。

    • \n

  • admin.E205: min_num の値は整数でなければなりません。

    • \n

  • admin.E206: formset の値は BaseModelFormSet を継承する必要があります。

    • \n
\n
\n
\n

GenericInlineModelAdminLink to this heading#

\n

以下のチェックは GenericInlineModelAdmin のインラインとして登録された ModelAdmin に対して行われます。

\n
    \n

  • admin.E301: 'ct_field' は <label> を参照していますが、これは <model> のフィールドではありません。

    • \n

  • admin.E302: ct_fk_field' は <label> を参照していますが、これは <model> のフィールドではありません。

    • \n

  • admin.E303: <model> に GenericForeignKey がありません。

    • \n

  • admin.E304: <model> の GenericForeignKey が、コンテンツタイプのフィールド <field name> とオブジェクトIDのフィールド <field name> を使用していません。

    • \n
\n
\n
\n

AdminSiteLink to this heading#

\n

デフォルトの AdminSite には、以下のチェックが実行されます。

\n\n
\n
\n
\n

authLink to this heading#

\n\n
\n
\n

contenttypesLink to this heading#

\n

モデルに GenericForeignKey または GenericRelation が含まれる場合、以下のチェックが行われます:

\n\n
\n
\n

postgresLink to this heading#

\n

django.contrib.postgres モデルフィールドに対しては、以下のチェックが実行されます。

\n\n
\n
\n

sitesLink to this heading#

\n

以下のチェックは CurrentSiteManager を使用しているモデルに対して行われます:

\n\n

以下のチェックは、django.contrib.sites が正しく設定されているかを確認します:

\n\n
\n
\n

staticfilesLink to this heading#

\n

以下のチェックは、django.contrib.staticfiles が正しく設定されていることを確認します。

\n\n
\n
","rootId":"system-check-framework","toc":[{"title":"API リファレンス","anchor":"api-reference","children":[{"title":"CheckMessage","anchor":"checkmessage","children":[]}]},{"title":"組み込みタグ","anchor":"builtin-tags","children":[]},{"title":"コアシステムチェック","anchor":"core-system-checks","children":[{"title":"非同期サポート","anchor":"asynchronous-support","children":[]},{"title":"後方互換性","anchor":"backwards-compatibility","children":[]},{"title":"キャッシュ","anchor":"caches","children":[]},{"title":"データベース","anchor":"database","children":[{"title":"MySQL と MariaDB","anchor":"mysql-and-mariadb","children":[]}]},{"title":"ファイルの管理","anchor":"managing-files","children":[]},{"title":"モデルフィールド","anchor":"model-fields","children":[{"title":"ファイルフィールド","anchor":"file-fields","children":[]},{"title":"関連フィールド","anchor":"related-fields","children":[]}]},{"title":"モデル","anchor":"models","children":[]},{"title":"セキュリティ","anchor":"security","children":[]},{"title":"シグナル","anchor":"signals","children":[]},{"title":"テンプレート","anchor":"templates","children":[]},{"title":"翻訳","anchor":"translation","children":[]},{"title":"URL","anchor":"urls","children":[]}]},{"title":"contrib アプリのチェック","anchor":"contrib-app-checks","children":[{"title":"admin","anchor":"admin","children":[{"title":"ModelAdmin","anchor":"modeladmin","children":[]},{"title":"InlineModelAdmin","anchor":"inlinemodeladmin","children":[]},{"title":"GenericInlineModelAdmin","anchor":"genericinlinemodeladmin","children":[]},{"title":"AdminSite","anchor":"adminsite","children":[]}]},{"title":"auth","anchor":"auth","children":[]},{"title":"contenttypes","anchor":"contenttypes","children":[]},{"title":"postgres","anchor":"postgres","children":[]},{"title":"sites","anchor":"sites","children":[]},{"title":"staticfiles","anchor":"staticfiles","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.1/ref/"}],"prev":{"docname":"ref/applications","title":"アプリケーション","url":"/ja/5.1/ref/applications/"},"next":{"docname":"ref/class-based-views/index","title":"ビルトインのクラスベースビュー API","url":"/ja/5.1/ref/class-based-views/"},"formats":{"html":"/ja/5.1/ref/checks/","markdown":"/ja/5.1/ref/checks.md","json":"/ja/5.1/ref/checks.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/checks.txt","official":"https://docs.djangoproject.com/ja/5.1/ref/checks/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}