You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Hydrogen执行npm run dev时访问异常路径报错,疑新版本所致

Shopify Hydrogen npm run dev 报错:EPERM 权限问题与异常重复路径

问题详情

执行npm run dev启动Hydrogen开发服务器时触发以下错误:

Error: EPERM: operation not permitted, mkdir 'C:\Users\Users\Ich\Desktop\hydrogen-storefront\node_modules\@shopify\hydrogen\dist\vite\virtual-routes\+types'
    at Object.mkdirSync (node:fs:1364:26)
    at C:\Users\Ich\Desktop\hydrogen-storefront\node_modules\@react-router\dev\dist\vite.js:973:29
    at Array.forEach (<anonymous>)
    at writeAll (C:\Users\Ich\Desktop\hydrogen-storefront\node_modules\@react-router\dev\dist\vite.js:970:36)
    at watch (C:\Users\Ich\Desktop\hydrogen-storefront\node_modules\@react-router\dev\dist\vite.js:928:9)

错误路径中多了一层重复的Users(实际项目路径为C:\Users\Ich\Desktop\hydrogen-storefront),导致系统无法创建目录。项目1个月前可正常运行,切换到旧版本@shopify/create-hydrogen@5.0.21替代最新版5.0.24后问题消失,怀疑新版本存在路径拼接bug。

临时解决方案

  • 回退到稳定版本:
    全局或本地回退@shopify/create-hydrogen到5.0.21版本:
    # 全局回退
    npm uninstall -g @shopify/create-hydrogen
    npm install -g @shopify/create-hydrogen@5.0.21
    
    # 本地项目回退
    npm install @shopify/create-hydrogen@5.0.21 --save-dev
    rm -rf node_modules package-lock.json
    npm install
    
  • 清理缓存与依赖:
    清理npm缓存并重新安装依赖,排除缓存导致的路径异常:
    rm -rf node_modules package-lock.json
    npm cache clean --force
    npm install
    

排查方向

  • 检查系统环境变量USERPROFILE或HOME是否被错误设置为C:\Users\Users\Ich,导致路径拼接时重复叠加
  • 查看项目vite.config.js或Hydrogen配置文件,确认是否存在硬编码的路径错误
  • 检查@react-router/dev包版本,错误栈显示该包负责目录写入,可尝试单独回退该包版本验证是否为依赖bug

内容的提问来源于stack exchange,提问作者MrCookiepants

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.13 00:06:02