convertToSafeFilename が全角スペースを素通りさせ、日本語ファイル名の添付が失敗する

[UramotoKazushi]

概要

チャットユースケースで書類を添付すると、ファイル名に全角スペース（U+3000）が含まれている場合に Bedrock Converse API が ValidationException を返し、添付が失敗します。ファイルサイズ・形式とは無関係です。

確認バージョン: v5.5.0 / main（2026-08-21 時点で未修正）

原因

packages/cdk/lambda/utils/fileNameUtils.ts の convertToSafeFilename:

const safeName = nameWithoutExt.replace(/[^a-zA-Z0-9\s\-()[\]]/g, '_');

JavaScript の \s は U+3000（全角スペース）やタブにマッチするため、これらは「許可文字」として置換されず残ります。しかし Bedrock の DocumentBlock.name はこれらを受け付けません。

漢字・かなは _ に置換されて問題なく通るため、空白系の文字だけがサニタイズを素通りしている状態です。日本語のファイル名では全角スペースが区切りとして日常的に使われるため、実務上かなりの頻度で発生します。

発生するエラー

ValidationException: The document file name can only contain alphanumeric characters,
whitespace characters, hyphens, parentheses, and square brackets. The name can't contain
more than one consecutive whitespace character. Check that the file name conforms to
these restrictions and retry your request.

エラー文は「連続する空白は不可」とだけ述べていますが、実測では全角スペースは1つでも拒否されます。

実測結果

Bedrock Converse API / jp.anthropic.claude-haiku-4-5-20251001-v1:0 で document.name のみを変えて検証しました。

document.name	結果
testname / test-name / test(1) / test[1]	OK
test name（半角スペース1つ）	OK
" testname" / "testname "（前後の半角スペース）	OK
test_name / test__name	OK（アンダースコアはエラー文に列挙されていないが実際は許容される）
test　name（全角スペース1つ）	NG
test name（半角スペース2連）	NG
test\tname（タブ）	NG
""（空文字）	NG（valid min length: 1）
300 文字	NG（長さ上限あり）

再現手順

1. テスト　資料.xlsx のように、名前の途中に全角スペースを含むファイルを用意する
2. チャットユースケースで添付して送信する
3. 回答が返らず、Lambda のログに上記 ValidationException が出力される

影響

自社環境で 1 日分の添付を集計したところ、添付された書類のうち約 19% がこの理由で失敗していました。形式にはほとんど依存しません（xls / doc / xlsx / docx / pdf いずれも 11〜18%）。

修正案

const safeName = nameWithoutExt
  .replace(/[^a-zA-Z0-9 \-()[\]]/g, '_')  // \s ではなく ASCII 半角スペースのみ許可
  .replace(/ {2,}/g, ' ')                  // 連続する空白を 1 つに畳む
  .trim();

加えて、置換後が空文字になった場合のフォールバックと、名前長の上限も必要かと思います。

同じパターンが AgentCore 経路にもあります

packages/web/src/utils/strandsUtils.ts の convertFileToStrandsContentBlock:

const fileName = file.name.replace(/[^a-zA-Z0-9\s\-()[\]]/g, 'X');

置換文字は X ですが、\s を許可している点は同一です。

関連

本件でエラーになっても、利用者にはファイル名が原因であることが伝わりません → #1672

[takke1986]

Opened #1677 for this.

Thank you for the write-up — the empirical table made the root cause easy to confirm, and I reproduced it independently against bedrock-runtime:Converse before and after the change (results are in the PR).

I followed your suggested fix (ASCII space only, collapse consecutive spaces), added the empty-name fallback, and applied the same change to the strandsUtils.ts occurrence you pointed out.

I left the file name length limit out of scope, since the exact limit does not appear to be documented and I did not want to guess a value. Happy to add it in a follow-up if a maintainer would prefer it handled here.

[UramotoKazushi]

Follow-up on the file name length limit you left out of scope.

We hit that limit in production and Bedrock states the bound in its own validation message:

ValidationException: 1 validation error detected: Value at
'messages.1.member.content.1.member.document.name' failed to satisfy constraint:
Member must have length less than or equal to 200

Observed on 2026-08-24, ap-northeast-1, via bedrock-runtime:ConverseStream from a deployment built on main. To be clear, this is a value we observed in the service's own error message, not something I found documented — treat it as an observation, not a spec. It is also rare in our data: 1 occurrence in 14 days, against 148 occurrences of the full-width space issue in the same window.

One thing worth noting if you do add a length guard: convertToSafeFilename can only make the name longer, never shorter. Non-allowed characters are replaced 1:1 with _, and the _<8 hex> hash suffix adds 9 more characters. So a 195-character Japanese file name becomes 204 and fails, even though the original was under the limit. Truncation would need to happen after the hash is appended, or reserve those 9 characters up front.

[UramotoKazushi]

Correction to my previous comment: the 200-character limit is documented after all.

DocumentBlock.name carries Length Constraints: Minimum length of 1. Maximum length of 200. in the Bedrock Runtime API reference:

https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_DocumentBlock.html

The same page also documents the rule you fixed in #1677 — the name may contain "Whitespace characters (no more than one in a row)". Sorry for hedging unnecessarily; you can treat 200 as a spec, not an observation.

What I could not find documented is any statement about document name uniqueness within a request. That one remains an observation from the error message.