Laravel Sail 10执行sail up -d出现503服务不可用问题求助

第一步：确认容器运行状态 #

• 执行sail ps查看所有容器的运行状态，重点关注laravel.test容器的STATUS列是否为Up。
• 若容器状态异常，实时查看应用日志定位问题：

  sail logs -f laravel.test
  

  日志里通常会显示Nginx/PHP-FPM启动失败、依赖服务连接异常等具体错误。

第二步：检查端口占用情况 #

• 默认端口80可能被本地Nginx、Apache或其他程序占用，执行以下命令排查：
  • Mac/Linux：lsof -i :80
  • Windows：netstat -ano | findstr ":80"
• 若端口被占用，修改项目根目录.env文件中的APP_PORT为其他值（如8080），然后重启服务：

  sail up -d
  

第三步：排查容器内服务状态 #

• 进入Laravel容器：

  sail shell
  

• 检查Nginx是否正常运行：

  service nginx status
  

  若未启动，尝试手动启动并查看报错：

  service nginx start
  

• 检查PHP-FPM服务状态：

  service php8.1-fpm status
  

  启动失败时的报错信息会直接提示问题根源（如配置文件错误、权限问题）。

第四步：修复目录权限 #

容器内/var/www/html目录权限异常可能导致应用无法加载，在容器内执行：

chown -R www-data:www-data /var/www/html

然后退出容器并重启服务：

exit
sail restart laravel.test

第五步：重建镜像清除缓存 #

如果以上步骤都无效，可能是镜像缓存导致的问题，执行以下命令重新构建镜像：

sail build --no-cache
sail up -d

第六步：检查依赖服务健康状态 #

查看docker-compose.yml中laravel.test依赖的MySQL、Redis等服务是否通过健康检查：

• 执行sail ps，观察这些服务的STATUS列是否带有(healthy)标记。
• 若显示(unhealthy)，查看对应服务的日志定位问题，比如MySQL：

  sail logs mysql
  

问题背景 #

今日执行sail up -d（注：原提问中sail artisan up -d应为笔误）后出现503 Service Unavailable错误，Docker已更新至最新版本，尝试多种命令未解决。相关配置如下：

docker-compose.yml

version: '3'
services:
    laravel.test:
        build:
            context: ./vendor/laravel/sail/runtimes/8.1
            dockerfile: Dockerfile
            args:
                WWWGROUP: '${WWWGROUP}'
        image: sail-8.1/app
        extra_hosts:
            - 'host.docker.internal:host-gateway'
        ports:
            - '${APP_PORT:-80}:80'
        environment:
            WWWUSER: '${WWWUSER}'
            LARAVEL_SAIL: 1
            XDEBUG_MODE: '${SAIL_XDEBUG_MODE:-off}'
            XDEBUG_CONFIG: '${SAIL_XDEBUG_CONFIG:-client_host=host.docker.internal}'
        volumes:
            - '.:/var/www/html'
        networks:
            - sail
        depends_on:
            - mysql
            - redis
            - meilisearch
            - selenium
    mysql:
        image: 'mysql/mysql-server:8.0'
        ports:
            - '${FORWARD_DB_PORT:-3306}:3306'
        environment:
            MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
            MYSQL_ROOT_HOST: "%"
            MYSQL_DATABASE: '${DB_DATABASE}'
            MYSQL_USER: '${DB_USERNAME}'
            MYSQL_PASSWORD: '${DB_PASSWORD}'
            MYSQL_ALLOW_EMPTY_PASSWORD: 1
        volumes:
            - 'sailmysql:/var/lib/mysql'
        networks:
            - sail
        healthcheck:
            test: [ "CMD", "mysqladmin", "ping", "-p${DB_PASSWORD}" ]
            retries: 3
            timeout: 5s
    redis:
        image: 'redis:alpine'
        ports:
            - '${FORWARD_REDIS_PORT:-6379}:6379'
        volumes:
            - 'sailredis:/data'
        networks:
            - sail
        healthcheck:
            test: [ "CMD", "redis-cli", "ping" ]
            retries: 3
            timeout: 5s
    meilisearch:
        image: 'getmeili/meilisearch:latest'
        platform: linux/x86_64
        ports:
            - '${FORWARD_MEILISEARCH_PORT:-7700}:7700'
        volumes:
            - 'sailmeilisearch:/data.ms'
        networks:
            - sail
        healthcheck:
            test: [ "CMD", "wget", "--no-verbose", "--spider",  "http://localhost:7700/health" ]
            retries: 3
            timeout: 5s
    mailhog:
        image: 'mailhog/mailhog:latest'
        ports:
            - '${FORWARD_MAILHOG_PORT:-1025}:1025'
            - '${FORWARD_MAILHOG_DASHBOARD_PORT:-8025}:8025'
        networks:
            - sail
    selenium:
        image: 'selenium/standalone-chrome'
        volumes:
            - '/dev/shm:/dev/shm'
        networks:
            - sail
networks:
    sail:
        driver: bridge
volumes:
    sailmysql:
        driver: local
    sailredis:
        driver: local
    sailmeilisearch:
        driver: local

hosts 文件

# localhost name resolution is handled within DNS itself.
#   127.0.0.1       localhost
#   ::1             localhost
#127.0.0.1 webserver.local

# Added by Docker Desktop
192.168.1.44 host.docker.internal
192.168.1.44 gateway.docker.internal
# To allow the same kube context to work on the host and the container:
127.0.0.1 kubernetes.docker.internal
# End of section

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