使用yarn link配置别名的NextJS项目构建Docker镜像失败如何解决

yarn link是本地环境专属的软链接配置，仅生效于当前开发机的yarn全局注册表和项目node_modules，Docker构建为完全隔离的文件系统环境，默认不会继承你本地的link配置，且你的现有Dockerfile中也没有执行对应的link操作，因此构建时无法识别别名路径，导致模块找不到报错。

方案1：使用NextJS原生路径别名（最推荐） #

yarn link本质是为本地开发外部依赖包设计的能力，并不适合作为项目内路径别名的配置方案。NextJS原生支持路径别名配置，无需额外依赖，全环境通用：

• 若为TypeScript项目，在根目录tsconfig.json的compilerOptions下新增配置：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "style/*": ["./style/*"], // 路径替换为你项目中style目录实际相对根目录的路径
      // 其他别名可按相同格式追加
    }
  }
}

• 若为JavaScript项目，在根目录新建jsconfig.json，填入和上述完全相同的配置即可。
  配置完成后删除原有yarn link的相关配置，无需修改Dockerfile，直接执行原有构建命令即可正常识别别名。

方案2：保留yarn link配置的修改方案 #

如果你确实是通过yarn link引入本地开发的外部依赖包，需要调整Dockerfile和构建规则：

1. 确保你link的本地依赖包目录没有被排除在Docker构建上下文外，且没有写入.dockerignore
2. 修改Dockerfile，在yarn install步骤后新增link相关操作，示例如下：

# 把本地依赖包复制到构建容器内
COPY ./your-local-style-package /style-pkg
# 注册本地包到容器内的yarn全局registry
RUN cd /style-pkg && yarn link
# 给项目link对应包
RUN cd /my-ui && yarn link style

另外注意：你的现有Dockerfile使用的node:10-alpine版本过低，已不被新版本NextJS支持，建议升级到node:18-alpine或更高的LTS版本，避免出现其他兼容问题。

内容的提问来源于stack exchange，提问作者Pelicer