docker-compose运行报yaml.scanner.ScannerError,compose配置问题求助
docker-compose配置报错排查
当前报错的直接触发原因
该报错属于YAML语法解析错误,核心是缩进不符合规范:
- YAML语法强制要求所有节点缩进必须使用半角空格,禁止使用制表符(Tab)、全角空格做缩进
- 从你贴出的配置内容看,
services节点下的注释行、app服务定义行前的空白是全角空格,解析器无法识别这类字符,扫描到第4行时会把该行误判为一个需要搭配冒号的简单键,最终抛出could not find expected ':'的解析错误
配置存在的其他隐藏问题
即使修正缩进让文件能通过YAML解析,后续执行还会遇到其他报错:
app服务段引用了app-network网络,但整个配置文件最外层没有定义这个网络,运行时会直接报网络不存在的错误- 注释的缩进必须和所属的代码节点对齐,不能在无父节点的层级随意放置注释
修正后的可正常运行的配置
version: '2.0' services: # PHP Service app: build: context: . dockerfile: Dockerfile image: cloudsigma.com/php container_name: app restart: unless-stopped tty: true environment: SERVICE_NAME: app SERVICE_TAGS: dev working_dir: /var/www/html/ volumes: - ./:/var/www/html/ - ./php/laravel.ini:/usr/local/etc/php/conf.d/laravel.ini networks: - app-network # 补充缺失的网络定义 networks: app-network: driver: bridge
配置编写注意事项
- 统一使用2个半角空格作为缩进层级,不要用Tab键生成缩进
- 服务段引用的自定义网络、命名卷,必须在配置文件的最外层对应段做显式定义,不能只在服务段声明引用
- 修改完配置后可以先通过YAML语法校验工具检查格式,提前排除解析类问题
内容的提问来源于stack exchange,提问作者John William
相关产品推荐
相关产品推荐

