使用JIB构建Spring Boot镜像后启动容器遇Docker Compose文件未找到问题

1. Docker Compose文件找不到的问题 #

• 确认命令执行的工作目录：执行docker compose up时，Compose默认会在当前工作目录查找docker-compose.yml或docker-compose.yaml。如果你的文件在子目录（比如./docker/），必须通过-f参数指定完整路径：

  docker compose -f ./docker/compose.yml up
  

  不要仅修改文件名却不指定路径，否则Compose仍会在当前目录查找默认命名的文件。
• 验证文件存在性与权限：用ls命令确认文件真实存在，且当前用户拥有读取权限：

  # 替换为你的文件路径
  ls -l ./docker-compose.yml
  

• 自定义文件名需显式指定：如果你的Compose文件名不是默认的两个，每次执行命令都必须加上-f <文件完整路径>，否则Compose无法识别。

2. 容器持续重启无法启动的问题 #

• 优先查看容器日志：这是排查启动失败的核心依据，执行以下命令获取关键日志片段：

  docker logs --tail 50 <容器名称或ID>
  

  也可以直接在Docker Desktop的容器详情页查看日志，日志会明确显示Java应用启动失败的具体原因（比如端口冲突、数据库连接失败、配置文件语法错误、依赖缺失等）。
• 绕过Compose直接验证镜像：先排除Compose配置的干扰，用docker run直接启动镜像，确认镜像本身是否正常：

  docker run -p 8080:8080 <你的镜像名:标签>
  

  如果直接启动也失败，说明问题出在JIB构建的镜像或应用本身；如果能正常启动，再回到Compose文件排查配置问题。
• 检查application.yml配置：重点确认：
  • 数据库、缓存等依赖服务的连接地址是否正确（如果用Compose服务名作为地址，需确保服务名一致且在同一网络）
  • 应用监听端口与Compose中映射的端口是否一致，且宿主机该端口未被占用
  • 环境变量（如JVM参数、数据库密码）是否配置正确
• 检查docker-compose.yml配置：
  • 调整restart策略：如果设为always，容器启动失败会不断重启，建议先改成no，排查完问题再调整
  • 完善依赖服务的健康检查：depends_on仅保证启动顺序，不保证服务就绪，需给依赖服务添加健康检查确保其就绪后再启动应用：

    services:
      mysql:
        image: mysql:8.0
        healthcheck:
          test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
          interval: 30s
          timeout: 10s
          retries: 3
      app:
        image: your-app-image
        depends_on:
          mysql:
            condition: service_healthy
    

  • 确认网络配置：确保应用容器和依赖服务处于同一Docker网络（默认Compose会创建专属网络，除非自定义了网络配置）

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