使用docker部署项目时报错，failed to checksum file node_modules/.pnpm/@[email protected]/node_modules

项目场景：

项目场景：使用docker部署项目时报错。

---

问题描述

项目中遇到的问题：

ERROR: failed to solve: failed to checksum file node_modules/.pnpm/@[email protected]/node_modules/@ctrl/tinycolor: archive/tar: unknown file mode ?rwxr-xr-x）

---

原因分析：

问题原因

1. node_modules 文件权限异常：Docker 在打包构建上下文时，无法正确识别某些文件的权限模式（如 ?rwxr-xr-x）。

2. node_modules 被包含在构建上下文中：Docker 默认会把当前目录的所有文件作为构建上下文发送给 Docker daemon，而 node_modules 体积大且可能包含异常权限文件。

3. pnpm 的依赖结构问题：pnpm 使用硬链接和符号链接管理依赖，可能导致 Docker 在计算文件 checksum 时出错。

---

解决方案：

解决方法

1. 确保 .dockerignore 忽略 node_modules

在项目根目录创建或修改 .dockerignore 文件，加入：

node_modules/
**/node_modules/