Shopify CLI主题开发出现Maximum Call Stack Size Exceeded错误求助

API 探路者

2026-7-1

解决Shopify CLI主题开发中的「Maximum Call Stack Size Exceeded」错误（关联stubborn-fs模块）

以下是针对这个问题的可行解决方案，按优先级尝试：

清理依赖缓存并重装项目依赖
先移除本地项目的node_modules，再清除包管理器缓存，避免依赖残留问题：
```
rm -rf node_modules
npm cache clean --force
# 若使用Yarn：
yarn cache clean
```
之后重新安装依赖：
```
npm install
# 或
yarn install
```
锁定stubborn-fs的稳定版本
该错误通常由stubborn-fs版本冲突引发递归调用栈溢出。在项目package.json中添加版本锁定配置：
```
"resolutions": {
  "stubborn-fs": "^1.2.5"
}
```
（npm用户需先安装npm-force-resolutions作为dev依赖，Yarn可直接生效），之后重新安装依赖确保版本生效。
重置Shopify CLI本地状态
重装CLI无效时，重置CLI的登录和配置状态：
```
shopify logout
shopify config reset
```
完成后重新登录并启动主题开发服务：
```
shopify login
shopify theme dev
```
修复本地文件系统权限
文件系统操作报错可能和权限不足有关，确保项目目录有读写权限：
Mac/Linux系统执行：
```
chmod -R 755 ./your-theme-directory
```
Windows用户右键主题文件夹，进入「属性-安全」面板，给当前用户分配完全控制权限。
排查主题文件异常
检查主题目录内是否存在超大文件，或Liquid模板间的循环引用（比如模板A包含模板B，模板B又包含模板A），这类情况也会触发栈溢出错误。