n8nでbinaryToStringエラーになる原因と解決法【filesystem-v2対応】

結論：binaryToStringエラーはExtract from Fileノードで解決します

n8nのbinaryDataMode=filesystem環境でRead File(s) From Diskを使い、後続のCodeノードでバイナリを読もうとしてエラーが出たことはありませんか。

解決策はシンプルです。Read File(s) From DiskノードのすぐあとにExtract from Fileノードを1つ追加するだけです。

これだけでbinaryToStringエラーは完全に解消されます。Codeノードでバイナリを直接読み出す処理は一切不要になります。

私が詰まった状況と試したこと（全部失敗した話）

今回のエラーに出会ったのは、n8nのワークフローでJSONファイルをRead File(s) From Diskで読み込み、後続のCodeノードでJSONとしてパースしようとしたときのことです。

環境はn8n 2.17.7 Self Hosted、binaryDataModeはfilesystem（docker-compose.ymlで設定）です。

最初に試したのは、よく見かけるbase64デコードの方法でした。

const base64 = $input.first().binary?.data?.data;
const jsonString = Buffer.from(base64, 'base64').toString('utf8');

結果は意味不明な文字列でした。出力を確認するとbinary.data.dataの中身が"filesystem-v2"という文字列になっていて、base64ではまったくなかったのです。

次にbinaryToStringヘルパーを試しました。

const jsonString = await this.helpers.binaryToString(item.binary.data);

今度はUnknown errorというエラーが出て即終了でした。

最後にbytesプロパティを使ってみました。

const bytes = item.binary.data.bytes;
const jsonString = Buffer.from(bytes).toString('utf8');

こちらはReceived type number (5270)というエラーでした。bytesはファイルサイズ（5270バイト）を表す数値であって、実データではなかったのです。

3種類のアプローチをすべて試して、30分以上詰まりました。正直、かなり困りました。そこでチャッピー（ChatGPT）にセカンドオピニオンを求めたところ、原因がはっきりわかりました。

なぜ読めないのか：filesystem-v2の正体

原因はbinaryDataMode: filesystemという設定にあります。

通常のメモリモード（デフォルト）では、バイナリデータはメモリ上に保持されます。この場合、binary.data.dataにはbase64エンコードされた実データが入っています。

一方、filesystemモードでは、バイナリデータはメモリではなくディスク上のファイルとして保存されます。その結果、binary.data.dataに実データは入りません。代わりに"filesystem-v2"という識別子（参照ポインタ）が入っています。

整理するとこうなります。

モード | binary.data.data の中身
--- | ---
memory（デフォルト） | base64エンコードされた実データ
filesystem | `"filesystem-v2"`（参照ポインタ）

Codeノードはこの参照ポインタを解決する手段を持っていません。だから何をやっても失敗し続けていたわけです。

「読めない」のではなく、「そこにデータが入っていない」という状態でした。これを理解してからは、解決の方向性がすぐに見えました。

解決方法：Extract from Fileノードの設定手順

解決策は非常にシンプルです。ノードを1つ追加するだけです。

ノード構成：

Read File(s) From Disk
↓
Extract from File  ← ここを追加する
↓
Code（任意）

Extract from Fileの設定：

• Operation：Convert to JSON
• Source Key：data

これだけです。

設定後、Extract from Fileノードを実行すると、$json.fileContentにJSONの内容が展開されます。後続のCodeノードでは以下のように参照できます。

const session = $('Extract from File').first().json.fileContent;
const keyword = session.keyword;

Codeノード自体が不要になるケースも多いです。JSONを読み込んでそのまま次のノードに渡すだけであれば、Extract from Fileノードの出力を直接使えます。