Laravel Sail测试通过但vendor/bin/phpunit在GitHub Actions中失败

先排查403错误的核心原因 #

本地测试通过但CI失败，通常是环境或数据逻辑差异导致：

• 权限校验遗漏：检查Consumer模型对应的Policy或Gate逻辑，测试里创建的User是否具备访问该消费者数据的权限。本地测试可能因为默认数据或手动赋值了权限，而GitHub Actions里的工厂创建的User没有触发权限赋值逻辑，导致接口返回403。
• 环境变量差异：确认GitHub Actions的.env配置（比如APP_ENV=testing）是否和本地一致，某些权限中间件可能会根据环境变量调整校验逻辑（比如本地APP_DEBUG=true跳过部分校验，CI里APP_DEBUG=false严格校验）。
• 中间件加载问题：检查路由是否挂载了额外的中间件（比如权限验证中间件），CI环境是否因为缓存（如路由缓存、配置缓存）导致中间件未正确加载，可在测试前添加./vendor/bin/sail artisan optimize:clear清除缓存。

如何在GitHub Actions配置Sail运行测试 #

完全可以在GitHub Actions里用Sail环境跑测试，以下是完整的Workflow配置示例：

name: Laravel Tests with Sail

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main, develop ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Copy environment file
        run: cp .env.example .env

      - name: Install Sail dependencies
        run: composer require laravel/sail --dev

      - name: Start Sail containers
        run: ./vendor/bin/sail up -d

      - name: Wait for database to be ready
        run: sleep 10 # 或者用更可靠的工具如wait-for-it

      - name: Install project dependencies
        run: ./vendor/bin/sail composer install --no-interaction --prefer-dist --optimize-autoloader

      - name: Generate application key
        run: ./vendor/bin/sail artisan key:generate

      - name: Run database migrations
        run: ./vendor/bin/sail artisan migrate --force

      - name: Run tests
        run: ./vendor/bin/sail artisan test

注意事项：

• 确保项目根目录有.env.example文件，包含测试环境所需的配置（如数据库连接信息）。
• 如果遇到内存不足问题，可在启动容器前设置环境变量：export COMPOSE_PROJECT_NAME=laravel-test && export MEMORY_LIMIT=512M。

同类问题的常见情况 #

很多开发者都遇到过本地与CI测试结果不一致的问题，除了上面提到的点，还有这些常见诱因：

• CI环境未运行测试数据填充（Seed），导致某些依赖数据缺失。
• 时间相关的逻辑差异（比如本地时区与CI时区不同，导致权限有效期校验失败）。
• 扩展依赖差异：本地安装了某些PHP扩展，CI环境未安装，导致部分逻辑异常。

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