项目启动相关 bug

项目启动突然启动不了

1、删除构建依赖（以当前网站项目为例 next 构建 删除 .next）node_modules 2、删除 lock 依赖树锁文件

项目启动完成 打开浏览器 空白 无内容

一般处理方式 比如 vscode 删除该目录下的 workspaceStorage 即可

1rm -rf ~/Library/Application\ Support/Code/User/workspaceStorage
复制

如果因为删除该目录文件导致其他问题 运行问题 则可以修复 ① 关闭所有 VS Code 窗口

退出 VS Code（必须退出干净）

1killall "Visual Studio Code"
复制

② 删除调试缓存目录

1rm -rf ~/Library/Application\ Support/Code/User/workspaceStorage
复制

③ 检查是否被注入 preload

1echo $NODE_OPTIONS
复制

如果类似以下

1--require "/Users/chemingqiang/Library/Application Support/Code/User/workspaceStorage/xxxx/ms-vscode.js-debug/bootloader.js"
复制

说明 VS Code 曾设置全局 preload。

清除它：

1echo "" >> ~/.zshrc
2echo "unset NODE_OPTIONS" >> ~/.zshrc
3source ~/.zshrc
复制

极端处理方式 删除所有 vs code 相关配置 重新安装

1rm -rf ~/Library/Application\ Support/Code
复制

⚠️ 会清空 VS Code 所有插件配置（包括主题、快捷键），慎用。 然后重新安装 VS Code 即可彻底修复。

Docker 构建时报错 内存不足

1tch1' -> '/root/.local/share/pnpm/store/v10/index/3d/7c1f06162ed210423f0f039f413e58361beda7f77522d558a8b71c6bfce087-micromatch@4.0.8.json'
2------
3Dockerfile:15
4--------------------
5  13 |     # 安装依赖，锁定版本，防止自动更新依赖
6  14 |     # network-concurrency 降低网络压力，避免卡死
7  15 | >>> RUN pnpm install --frozen-lockfile --network-concurrency=1
8  16 |
9  17 |     # 后续复制完整源码，包括构建脚本和 .next 文件夹
10--------------------
11failed to solve: process "/bin/sh -c pnpm install --frozen-lockfile --network-concurrency=1" did not complete successfully: exit code: 1
12[root@VM-12-6-opencloudos cheche-deploy]#
复制

一般是因为 docker 构建时内存不足导致的，解决办法是增加 docker 构建时的内存限制。

处理方案

1# 1. 列出所有镜像并记录您需要保留的镜像ID
2docker images
3
4# 2. 清理悬空镜像（最安全的清理方式）
5docker image prune -f
6
7# 3. 清理构建缓存
8docker builder prune -f
9
10# 4. 清理未使用的网络
11docker network prune -f
12
13# 5. 清理停止的容器（如果需要）
14docker container prune -f --filter "status=exited"
复制