docker 趣事
内容提要
Docker新手在前端容器化构建时遇到“This relative module was not found”报错，排查一天无果。最终发现是.dockerignore中三年前同事添加的src/规则屏蔽了源码目录，导致COPY未复制src文件夹。教训：搜索不到解决方案时，问题往往出在冷门配置上。
延伸解读
排查方向：从代码到构建上下文
作者最初怀疑路径大小写或WORKDIR，但实际问题是.dockerignore屏蔽了src目录。这提醒我们，当构建报错指向缺失模块时，除了检查代码本身，还应确认构建上下文是否完整。Docker在COPY时受.dockerignore影响，若忽略规则包含源码目录，即使Dockerfile写法正确，文件也不会被复制。
历史配置的潜在风险
文中.dockerignore的src/规则是三年前同事添加的，作者接手项目仅一年。这反映了遗留配置可能因人员更替而成为隐形陷阱。对于运维或接手他人项目的开发者，定期审查.dockerignore、Dockerfile等构建配置，了解其历史意图，能避免类似问题。
搜索无果时的应对思路
作者搜索报错信息未找到解决方案，最终靠灵感发现.dockerignore问题。这说明通用错误信息可能对应非典型原因。当常见排查无效时，应转向检查项目特有的配置，如忽略文件、环境变量或构建脚本，而非局限于错误关键词。
Q&A
Docker构建前端项目时出现“This relative module was not found”错误，可能是什么原因？
可能是.dockerignore文件屏蔽了src目录，导致COPY命令没有复制src文件夹，构建时找不到入口文件。
.dockerignore文件中的规则如何影响Docker构建？
.dockerignore中的规则会排除指定文件或目录，使它们不被复制到镜像中。例如，如果忽略了src/，那么COPY命令就不会复制src目录，导致构建失败。
如何确认Docker构建时是否遗漏了某些文件？
可以在Dockerfile中添加RUN ls命令查看当前目录内容，或者检查.dockerignore文件是否排除了必要文件。
为什么在本地构建正常，但在Docker中构建却报错？
因为Docker构建环境与本地环境不同，.dockerignore可能排除了某些文件，而本地构建没有这个限制。
接手老项目时，如何避免因历史配置导致Docker构建问题？
应仔细检查.dockerignore、Dockerfile等配置文件，了解其历史修改，必要时进行测试构建。
遇到Docker构建错误，搜索不到解决方案时该怎么办？
可以检查一些不常见的配置，如.dockerignore，或者尝试在Dockerfile中添加调试命令，如ls，来定位问题。
