fs: cpSync copyDir fast path can terminate on filesystem errors
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 64/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- cpp, javascript, node.js
調査の方向性
Issue のスクリプトで Windows の失敗を再現し、その後 src/node_file.cc と CpSyncCopyDir の実装を調べてください。ディレクトリの反復処理、パスの正規化、ファイル種別のチェックを追跡し、ファイルシステムの失敗がプロセスを終了させるのではなく、捕捉可能な JavaScript 例外になることを確認してください。
索引モデルが issue の本文から書いたものです。
説明
Version
v22.17.0 and later; verified against v27.0.0-pre built from current main.
Platform
Microsoft Windows NT 10.0.26100.0 x64
Subsystem
fs
What steps will reproduce the bug?
Run this script on Windows:
'use strict';
const assert = require('node:assert');
const { execFileSync, spawnSync } = require('node:child_process');
const {
cpSync,
existsSync,
mkdirSync,
rmSync,
writeFileSync,
} = require('node:fs');
const { tmpdir } = require('node:os');
const { join } = require('node:path');
function run(command, args) {
return execFileSync(command, args, {
encoding: 'utf8',
stdio: ['ignore', 'pipe', 'pipe'],
});
}
function currentWindowsUser() {
return run('whoami', []).trim();
}
function restrictDirectory(dir) {
run('icacls', [dir, '/deny', `${currentWindowsUser()}:(OI)(CI)(RX)`]);
}
function restoreDirectory(dir) {
if (existsSync(dir)) {
run('icacls', [dir, '/remove:d', currentWindowsUser()]);
}
}
if (process.argv[2] === 'child') {
assert.throws(() => {
cpSync(process.argv[3], process.argv[4], { recursive: true });
});
process.exit(0);
}
const root = join(tmpdir(), `node-cpsync-${process.pid}`);
const src = join(root, 'src');
const dest = join(root, 'dest');
const restrictedDir = join(src, 'restricted');
mkdirSync(restrictedDir, { recursive: true });
writeFileSync(join(src, 'readable.txt'), 'readable\n');
writeFileSync(join(restrictedDir, 'blocked.txt'), 'blocked\n');
restrictDirectory(restrictedDir);
try {
const child = spawnSync(process.execPath, [__filename, 'child', src, dest], {
encoding: 'utf8',
});
console.log({
status: child.status,
signal: child.signal,
stdout: child.stdout,
stderr: child.stderr,
});
} finally {
restoreDirectory(restrictedDir);
rmSync(root, { recursive: true, force: true });
}
The important part is that fs.cpSync(src, dest, { recursive: true }) is called without a filter option, so it uses the native copyDir fast path.
How often does it reproduce? Is there a required condition?
It reproduces when the native fs.cpSync() copyDir fast path encounters a filesystem error during directory iteration, path canonicalization, or file type checks.
The fast path is used for recursive directory copies when no filter option is provided. Passing filter: () => true avoids this path and falls back to the JavaScript implementation.
What is the expected behavior? Why is that the expected behavior?
fs.cpSync() should report the filesystem failure as a JavaScript exception that callers can catch with try/catch or assert.throws().
Filesystem APIs should convert native filesystem failures into JavaScript errors instead of terminating the process.
What do you see instead?
Some std::filesystem calls in the native copyDir implementation use throwing overloads. When those operations fail, the C++ exception can bypass Node's normal error conversion.
Instead of a catchable JavaScript exception, the process can terminate in the native layer.
Additional information
This appears to come from src/node_file.cc's CpSyncCopyDir implementation. Some calls already use std::error_code, but others use throwing std::filesystem overloads, including directory iteration and file type/path checks.
The fix is to use non-throwing std::filesystem overloads throughout the copyDir path and convert each failure with ThrowStdErrException.
- 主要言語
- JavaScript
- スター
- 122k
- フォーク
- 37.4k
- 平均マージ
- 4日 4時間
- マージ済み PR(30日)
- 276
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
nodejs/node のほかの issue
-
doc
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
build
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
-
feature request
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
似ている issue
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
githubnext/gh-aw-workshop#3692 ·
-
agent/guide documentation hive/hosted-available-lke648397-260827-5n31
難易度 2/5 1〜3時間 初心者へのやさしさ 90/100
-
Add: BuyPass TV オープンchannels:add check:passed
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
S: triage
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 78/100