Parcel.js更新依赖后构建耗时过长且大量报错EISDIR: illegal operation on a directory, read

核心原因 #

EISDIR错误本质是程序尝试把目录当作普通文件读取，你遇到的构建耗时暴涨但最终能成功的问题，是Parcel依赖解析的容错重试机制导致的，具体触发原因通常是以下几种：

• Parcel版本自身存在解析bug：npm update后你大概率升级到了有路径解析缺陷的Parcel版本，比如2.9.0~2.9.2版本就有这类已知问题：当导入路径存在「同名文件和目录」的歧义，或者第三方依赖的package.json入口字段指向目录时，旧版本会直接按规则 fallback 读取目录下的index.js，有bug的版本会先反复尝试把目录当文件读取，触发多次EISDIR报错后才走fallback逻辑，几百次重试叠加下来就把原本10秒的构建拖到10分钟以上，最终因为fallback生效所以构建产物能正常运行。
• 项目导入路径有歧义：从报错能看到每次错误都和constant.js相关，你可以检查这个文件同级目录下有没有叫constant的文件夹：如果你代码里导入这个文件时写的是import './constant'没加.js后缀，Parcel解析时会先尝试读constant（匹配到目录，报EISDIR错），再尝试读constant.js、constant.ts这类后缀的文件，每次导入都触发一次报错和重试，要是项目里大量地方导入这个路径，就会出现上百条重复报错。
• 第三方依赖导入不规范：你更新的依赖里可能包含不规范的第三方包，内部导入语句写的是指向目录的相对路径但没加尾部/，比如import './config'但实际包内config是目录，里面有index.js，同样会触发上述重试逻辑。

快速修复方案 #

• 先确认constant.js同级是否存在同名constant目录，有的话要么改目录名，要么把所有导入该文件的语句补全.js后缀，改成import './constant.js'，消除路径歧义。
• 回退Parcel到你更新依赖之前的正常版本，或者直接升级到最新稳定版，这个解析bug已经在后续的Parcel补丁版本里修复了。
• 排查项目的路径别名配置，确认没有别名指向目录但导入时未补全路径的情况。

内容的提问来源于stack exchange，提问作者Huqe Dato