Docker容器内React项目package.json本地包链接报错：找不到common-package

我来帮你排查这个问题，从你的配置来看，核心问题出在Docker内的权限处理和yarn对本地链接依赖的解析逻辑上，下面一步步给你解决：

问题分析 #

你在react-app的package.json里用了"common-package": "link:../common-package"，这个写法本身没问题，但在Docker容器中，有两个关键卡点：

1. 频繁切换root和node用户，导致yarn创建软链接时可能出现权限不足，或者软链接的所有者异常，node运行时无法读取；
2. 你在common-package执行yarn build后，需要确保它的package.json里的main字段指向了构建后的入口文件（比如dist/index.js），否则即使链接成功，node也找不到模块入口。

解决方案 #

1. 重构Dockerfile，统一权限管理 #

尽量减少root用户的操作，全程用node用户处理依赖安装和构建，避免权限混乱：

修改后的Dockerfile：

FROM node:18.7.0-alpine

# 安装系统依赖（仅这里用root）
USER root
RUN apk update && apk add python3 make g++ yarn

# 创建所有需要的目录并设置node为所有者
RUN mkdir -p /home/node/common-package /home/node/react-app \
    && chown -R node:node /home/node

# 切换到node用户，后续所有操作都用这个用户
USER node

# 处理common-package
WORKDIR /home/node/common-package
COPY ./ProjectA/Common/CommonPackage ./
RUN yarn install && yarn build

# 处理react-app
WORKDIR /home/node/react-app
COPY ./ProjectB/ReactApp/fe ./
RUN yarn install

EXPOSE 3000
CMD [ "node", "./server/bootstrap.ts" ]

2. 检查common-package的package.json配置 #

确保common-package的package.json里有正确的main字段，指向构建后的入口文件，比如：

{
  "name": "common-package",
  "main": "dist/index.js", // 这里要对应你的build输出目录和入口文件
  "scripts": {
    "build": "tsc" // 假设你用TypeScript编译
  }
}

如果你的build产物不在dist目录，就改成实际的路径，否则node在导入common-package时会找不到入口。

3. 验证软链接是否正确创建 #

可以在Dockerfile的RUN yarn install之后加一行验证命令，确保软链接已生成：

RUN ls -la node_modules/common-package

这行命令会输出node_modules/common-package的链接信息，如果显示是指向../common-package的软链接，说明链接成功。

为什么之前的配置会失败？ #

你之前的Dockerfile中，在安装react-app依赖时切换回了root用户执行yarn，这会导致生成的软链接所有者是root，而后续用node用户启动应用时，可能没有权限读取这个链接指向的目录，最终出现Cannot find module的错误。

按照上面的步骤修改后，应该就能解决问题了！

内容的提问来源于stack exchange，提问作者M.Pogorzelski