跳到主要内容

构建失败相关

构建阶段问题多数为 docker 报错，绝大部分是因为没有正确配置 Dockerfile。 可参见优化容器镜像，或在网上搜索 docker 相关解决方案及教程。

遇到报错信息“network connection aborted.”如何处理？​

因为访问国外网络不稳定的不可抗力因素，建议尽量选用国内站作为镜像源下载依赖和扩展。

缺少依赖报错如何处理？例如：java.lang.NoClassDefFoundError: Could not initialize class xxx​

Dockerfile 中缺少对应的依赖安装命令。 建议优先换用更完整的构建基础镜像而非直接增加依赖安装命令（RUN apk xxx），更加简单方便，且可以提高构建速度。 请到 GitHub-Containers 的 dockerhub 官方仓库 自行选择合适的基础镜像（默认已包含了所有您需要的依赖），然后在 Dockerfile 中替换“FROM xxxxx as build” 命令。

遇到报错信息“xxxxxx: no such file or directory”如何处理？​

  • 确保代码仓库/代码包中确实存在该文件且路径正确。
  • 确保 .gitignore 或者 .dockerignore 中，没有包含这个文件。如果包含将会被构建忽略。去除即可。
  • 确保 Dockerfile 中的 COPY 命令，拷贝文件的时候没有修改原有的文件路径。

无报错日志显示空白该如何处理？​

大概率是构建超时（> 10分钟）。请优化容器镜像，提高构建速度，防止超时。