Laravel Sail启动报错：supervisord配置中用户sail无效 求解决方案

使用Laravel Sail、MySQL和Mailhog包时，执行sail命令出现以下错误：

Error: Invalid user name sail in section 'program:php' (file: '/etc/supervisor/conf.d/supervisord.conf')
For help, use /usr/bin/supervisord -h

vendor/laravel/sail/runtimes/8.1/supervisord.conf 文件内容：

[supervisord]
nodaemon=true
user=root
logfile=/var/log/supervisor/supervisord.log
pidfile=/var/run/supervisord.pid

[program:php]
command=/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=0.0.0.0 --port=80
user=sail
environment=LARAVEL_SAIL="1"
stdout_logfile=/dev/stdout
stdout_logfile_maxbytes=0
stderr_logfile=/dev/stderr
stderr_logfile_maxbytes=0

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'
            - '${VITE_PORT:-5173}:${VITE_PORT:-5173}'
        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
    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:
            - 'sail-mysql:/var/lib/mysql'
            - './vendor/laravel/sail/database/mysql/create-testing-database.sh:/docker-entrypoint-initdb.d/10-create-testing-database.sh'
        networks:
            - sail
        healthcheck:
            test: ["CMD", "mysqladmin", "ping", "-p${DB_PASSWORD}"]
            retries: 3
            timeout: 5s
    mailhog:
        image: 'mailhog/mailhog:latest'
        ports:
            - '${FORWARD_MAILHOG_PORT:-1025}:1025'
            - '${FORWARD_MAILHOG_DASHBOARD_PORT:-8025}:8025'
        networks:
            - sail
networks:
    sail:
        driver: bridge
volumes:
    sail-mysql:
        driver: local

错误原因是Docker容器内不存在sail用户，导致supervisor无法切换用户执行PHP命令，按以下步骤修复：

• 修改supervisord配置
  打开vendor/laravel/sail/runtimes/8.1/supervisord.conf，将[program:php]段中的user=sail改为user=root，或者直接删除这一行（因为supervisord本身已以root用户运行）。修改后该段内容如下：

  [program:php]
  command=/usr/bin/php -d variables_order=EGPCS /var/www/html/artisan serve --host=0.0.0.0 --port=80
  user=root
  environment=LARAVEL_SAIL="1"
  stdout_logfile=/dev/stdout
  stdout_logfile_maxbytes=0
  stderr_logfile=/dev/stderr
  stderr_logfile_maxbytes=0
  

• 重建Docker镜像
  修改配置后需要重新构建镜像，执行命令：

  sail build --no-cache
  

• 重启服务
  镜像构建完成后，启动服务：

  sail up -d
  

可选优化（非必需） #

如果希望用非root用户运行，可检查vendor/laravel/sail/runtimes/8.1/Dockerfile是否包含创建sail用户的代码：

RUN useradd -ms /bin/bash sail

如果没有，添加该行后再重新构建镜像即可。开发环境下直接使用root用户完全可行，无需额外配置。

内容的提问来源于stack exchange，提问作者Jean Luc Gouirand