Calcular con precisión la sobrecarga de multipart/form-data

¿Alguna vez ha experimentado un error 413 cuando un archivo es de solo 9MB durante la prueba de límite de tamaño de carga de archivos? Una de las causas es la sobrecarga de <code>multipart/form-data</code>. Al cargar un archivo a través de un formulario HTML, el cuerpo de la solicitud HTTP contiene no solo el archivo en sí sino también metadatos adicionales. Este artículo explica el método de cálculo preciso para esa sobrecarga y los puntos a considerar durante la prueba.

Estructura de multipart/form-data

<code>multipart/form-data</code> definido en RFC 2046 tiene una estructura donde cada parte se separa mediante una cadena de límite. Un cuerpo de solicitud HTTP real se ve así.

POST /upload HTTP/1.1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryABC123
Content-Length: 10000xyz

------WebKitFormBoundaryABC123
Content-Disposition: form-data; name="file"; filename="test.png"
Content-Type: image/png

[ファイルのバイナリデータ]
------WebKitFormBoundaryABC123--

Desglose de sobrecarga

La sobrecarga de una solicitud típica de carga de archivo consta de los siguientes elementos.

Para un formulario simple con un solo archivo, la sobrecarga es aproximadamente de <strong>200–400 bytes</strong>. Si hay campos de formulario adicionales (como entradas de texto), la sobrecarga aumenta en consecuencia, pero típicamente se mantiene entre varios cientos de bytes a varios kilobytes.

Por qué ocurre el error 413

El <code>client_max_body_size</code> de Nginx limita el tamaño de todo el <strong>cuerpo de la solicitud</strong>. En otras palabras, el valor configurado debe incluir sobrecarga.

# 10MiB のファイルをアップロードさせたい場合
# オーバーヘッド（約1KB）を考慮して少し大きめに設定
client_max_body_size 11m;  # MiB単位: 11 MiB = 11,534,336 バイト

Para PHP, debe configurar dos ajustes: <code>upload_max_filesize</code> (por archivo) y <code>post_max_size</code> (cuerpo POST completo).

; php.ini
upload_max_filesize = 10M   ; ファイル単体の上限: 10 MiB
post_max_size = 11M         ; POSTボディ全体の上限: 11 MiB（オーバーヘッド分を加算）

Método de medición precisa de la sobrecarga

Si desea conocer el sobrecargo real con precisión, puede enviar solicitudes con <code>curl</code> y medir el tamaño de la solicitud.

# ファイルのバイト数を確認
wc -c test-10mb.png
# → 10485760 test-10mb.png

# curl でアップロードしてリクエストサイズを確認
curl -X POST https://example.com/upload \
  -F "file=@test-10mb.png" \
  -w "リクエストボディサイズ: %{size_upload} バイト\n" \
  -o /dev/null -s
# → リクエストボディサイズ: 10486062 バイト（差: 302バイト）

Diferencia con respecto a la codificación Base64

Con <code>multipart/form-data</code>, los datos binarios del archivo se envían tal cual (sin codificación Base64). La codificación Base64 solo se necesita al enviar binarios con <code>application/x-www-form-urlencoded</code> o al enviar archivos en cuerpos JSON (como <code>data:image/png;base64,...</code>).

Puntos a considerar en las pruebas

• Determine si la verificación de límite del servidor es para "archivos individuales" o "cuerpo de solicitud completo"
• Como Nginx limita las solicitudes antes de PHP, también verifique <code>client_max_body_size</code> de Nginx
• La carga simultánea de múltiples archivos aumenta la sobrecarga
• El overhead también incluye campos de formulario adicionales (nombre, comentario, etc.)

Utilizando los <a href="/ja/files/threshold/">archivos de prueba de umbral</a> en DevLab, puede verificar el comportamiento de carga real con tamaños de archivo cercanos al límite. Valide en conjunto con su configuración de Nginx/Apache/PHP.

Resumen

• El overhead de <code>multipart/form-data</code> es aproximadamente <strong>200–400 bytes</strong> (para un archivo)
• Dado que <code>client_max_body_size</code> de Nginx limita todo el cuerpo de la solicitud, configúralo un poco más grande que el límite de tamaño de archivo
• PHP requiere configurar dos directivas: <code>upload_max_filesize</code> (archivo individual) y <code>post_max_size</code> (cuerpo POST completo).
• Al Enviar mediante JSON + Base64, el Tamaño del Archivo Aumenta Aproximadamente un 33%