Difyでナレッジが5件までしか登録できず、エラーも出ないので気づけなかった話

はじめに

Dify OSS（v1.11.x）でナレッジを登録していて、
「一括アップロードしたのに、なぜか一部しか登録されていない」
という状態にハマりました。

エラー表示は出ない
UIは普通に処理が進んだように見える
でも、登録されたのは5ファイルだけ

最初は
「処理が遅れている？」
「バックグラウンドで続いている？」
と思って待っていました。

しかし、いくら待っても増えない。

結論から言うと、これは Difyの設定による“仕様” で、
しかも 非常に気づきにくい挙動 でした。

症状：エラーが出ないのに、ナレッジが増えない

今回の挙動は、次のようなものでした。

6ファイル以上をまとめてアップロード
明確なエラーメッセージは出ない
登録結果を見ると 5ファイルだけ存在
残りは 無かったことになっている

👉 失敗したこと自体に気づけない のが最大の問題でした。
以下の図の場所です。

なぜ気づきにくいのか

Difyには ナレッジ登録数のデフォルト制限があります。

UPLOAD_FILE_BATCH_LIMIT=5

この設定は、

1回の操作でアップロードできる最大ファイル数

を意味します。

ここが厄介なポイント

5件までは 完全に正常
6件目以降だけが 制限に引っかかる
UI上では
- 明確なエラーが出ない
- 「5件だけ成功」という結果になる場合がある

つまり、

「一部成功しているせいで、失敗に気づけない」

という状態になります。

一番ハマりやすい挙動

Difyの挙動には大きく2パターンありますが、
今回問題になったのは パターン② です。

パターン①（まだ親切）

6件目以降でエラー表示が出る
失敗したことが分かる

❌ パターン②（今回）

エラー表示なし
5件だけ登録される
残りは黙って無視される
気づいたのは後から

👉 UIが壊れているようにすら見えないため、原因特定が遅れます。

原因は不具合ではなく「設定」、不親切なUIです。

これは Difyのバグではありません。

.env にある次の設定が原因です。

UPLOAD_FILE_BATCH_LIMIT=5

デフォルト値が 5 のため、

5件 → 成功
6件以上 → 制限超過 → API側で拒否

という挙動になります。

対策：登録数制限を明示的に増やす

例：20件まで一括登録したい場合

UPLOAD_FILE_BATCH_LIMIT=20

反映：

cd ~/dify/docker
docker compose down
docker compose up -d

これで、

一括アップロードしても
途中で黙って失敗することがなくなります

「数」を直しても、次にハマる制限

数の制限を直したあと、次に出てきやすいのが サイズ制限 です。

ファイルサイズ制限（API側）

UPLOAD_FILE_SIZE_LIMIT=15

Nginx側（ここが原因のことが多い）

NGINX_CLIENT_MAX_BODY_SIZE=100M

この2つが噛み合っていないと、

途中で失敗
413エラー
やはり分かりにくい失敗

につながります。

実務でおすすめの設定例

UPLOAD_FILE_BATCH_LIMIT=20
UPLOAD_FILE_SIZE_LIMIT=50
NGINX_CLIENT_MAX_BODY_SIZE=200M

👉 「数」「サイズ」両方で気づきにくい失敗を防げる構成です。

まとめ：一番怖いのは「静かに失敗すること」

今回一番厄介だったのは、

❌ エラーが出ない
❌ UIが壊れているように見えない
❌ でも、結果は欠けている

という 静かな失敗 でした。

Difyでナレッジ登録が思った通りに増えないときは、

「制限に引っかかって、黙って捨てられていないか？」

をまず疑ってください。

特に
UPLOAD_FILE_BATCH_LIMIT=5
これは知らないと確実にハマります。