# 守护进程错误响应：无效的引用格式：仓库名称必须为小写

- **ID:** `docker/invalid-reference-format`
- **领域:** docker
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 95%

## 根因

镜像名称或标签包含大写字母或无效字符，Docker 不允许仓库名称包含这些字符。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Docker 24.0.6 | active | — | — |
| Docker 25.0.3 | active | — | — |
| Docker 23.0.5 | active | — | — |

## 解决方案

1. ```
   Rename the image to use only lowercase letters, numbers, and allowed symbols. Example: change 'MyApp:latest' to 'myapp:latest'.
   ```
2. ```
   If using docker-compose, ensure the image field is lowercase: 'image: myapp:1.0' instead of 'image: MyApp:1.0'.
   ```

## 无效尝试

- **** — Using quotes around the image name does not fix uppercase letters; Docker still parses them as invalid. (90% 失败率)
- **** — Changing the tag to uppercase does not help; the repository name itself must be lowercase. (95% 失败率)