Gitlab CI/CD拉取python 3.9镜像失败，提示无效引用格式如何修复？

错误原因分析 #

你遇到的invalid reference format错误，核心问题是**.gitlab-ci.yml中的镜像格式写错了**：

WARNING: Failed to pull image with policy "if-not-present": invalid reference format (manager.go:237:0s)
ERROR: Job failed: failed to pull image "python 3.9" with specified policies [if-not-present]: invalid reference format (manager.go:237:0s)

Docker镜像的命名规则是镜像名称:标签，你写成了python 3.9（用空格分隔），这种格式会被Docker识别为无效的镜像引用，自然拉取失败。

另外，虽然你在config.toml里已经配置了默认镜像python:3.9，但.gitlab-ci.yml中的镜像配置优先级更高，会覆盖Runner的默认设置，所以修改pull_policy解决不了问题。

修复步骤 #

只需要修改.gitlab-ci.yml中的image字段，把空格换成冒号即可：

修改前的.gitlab-ci.yml片段： #

image: python 3.9

修改后的.gitlab-ci.yml片段： #

image: python:3.9

修改后重新触发CI/CD作业，Runner就能正确识别并拉取Python 3.9镜像了。

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