ファイルアップロードや大きめの JSON 送信で、ASP.NET Core アプリが 413 Payload Too Large を返す。制限はアプリ・Kestrel・IIS・手前のプロキシと複数層にあり、どこで切れたか分からないまま設定を足すと迷走する。まず発生層の特定から。
先に結論
- 413 は「どこかの層のサイズ上限」を超えたサイン。アプリに届く前に切れていることが多い
- 層は主に4つ: Kestrel の上限、アクション側の属性、IIS の要求フィルタ、nginx などのプロキシ
- アプリのログにリクエストが残っていないなら、アプリより手前で切れている
- 上限を上げるなら、必要箇所だけ・必要量だけ。無制限化はしない
制限の層と既定値の目安
- Kestrel: MaxRequestBodySize の既定は約 30MB(28.6MiB)。超えると例外経由で 413 になる
- アクション属性: [RequestSizeLimit] / [DisableRequestSizeLimit] が付いている箇所だけ別上限になる
- フォーム(multipart): MultipartBodyLengthLimit という別の上限がある
- IIS ホスティング: 要求フィルタリングの maxAllowedContentLength(既定 約28.6MB)が別に効く
- プロキシ: nginx の client_max_body_size(既定 1MB と小さい)、ALB 等にも上限がある
どこで切れたかの切り分け
- レスポンスを返したサーバー名(Server ヘッダやエラー画面の体裁)で層の当たりを付ける
- アプリのアクセスログ / 例外ログに到達形跡があるか。到達していないなら手前の層
- サイズを段階的に変えて試し、どの閾値で失敗に変わるかで該当層を特定する
- 開発環境(Kestrel 直)では再現せず、本番(IIS / プロキシ経由)だけで出るなら、差分はホスティング層にある
設定の書き方(Kestrel の例)
アプリ全体で上げるのではなく、必要なエンドポイントに [RequestSizeLimit] を付けるのが基本。全体側を上げる場合の書き方はこうなる。
builder.WebHost.ConfigureKestrel(options =>
{
options.Limits.MaxRequestBodySize = 50 * 1024 * 1024; // 50MB
});
- IIS 側は web.config の requestLimits maxAllowedContentLength(バイト指定)を合わせる
- nginx 側は client_max_body_size をアプリ側の上限と揃える
- 層ごとに値がバラバラだと「一番小さい層」が実効上限になるので、揃えて把握する
上げる前に考えること
- そもそもそのサイズの入力が業務上必要か。画像・ファイルを API で受けず、ストレージへの直接アップロードに逃がす設計も選択肢
- 上限を上げると、その分メモリ・帯域・処理時間の攻撃面も広がる。認証・検証とセットで
- クライアント側の実装(分割送信・圧縮)で解決できるケースもある
ざっくりまとめ
- 413 は層の特定が先。アプリ未到達なら Kestrel をいじっても直らない
- 実効上限は「経路上の最小値」。各層の値を一覧で把握する
- 無制限化はしない。必要な場所に必要な分だけ
関連記事