You need to enable JavaScript to run this app. docker-compose运行报yaml.scanner.ScannerError,compose配置问题求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 01:15:01