Laravel部署到GCP时出现'Please provide a valid cache path'错误

This error happens because Laravel depends on specific subdirectories inside storage/framework to compile views, store cache data, and manage user sessions. Heroku’s buildpack automatically sets up these directories for you, but GCP’s deployment environment (whether you’re using App Engine, Cloud Run, or Compute Engine) doesn’t handle this by default. Here’s how to fix it:

1. Track Required Storage Directories in Git #

Laravel’s default .gitignore skips empty directories, so if these folders don’t exist locally (or aren’t tracked by Git), they won’t be included in your deployment package. Create the missing directories and add a .gitkeep file to each to ensure Git tracks them:

Run these commands in your project root:

mkdir -p storage/framework/{views,cache,sessions,testing}
touch storage/framework/views/.gitkeep
touch storage/framework/cache/.gitkeep
touch storage/framework/sessions/.gitkeep
touch storage/framework/testing/.gitkeep

Commit these changes to Git so they’re included when you deploy to GCP.

2. Set Proper Permissions During Deployment #

GCP’s runtime might restrict write access to the storage and bootstrap/cache directories. Add permission commands to your deployment workflow:

• If using a Dockerfile, add these lines:

  RUN chmod -R 775 storage bootstrap/cache
  RUN chown -R www-data:www-data storage bootstrap/cache
  

• If using Cloud Build (cloudbuild.yaml), include these permission steps in your build process.

3. Auto-Create Directories via Composer Scripts #

To automate this step every time dependencies are installed, update your composer.json to include directory creation in the post-install-cmd script. Modify the "scripts" section like this:

"scripts": {
    "post-root-package-install": [
        "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
    ],
    "post-create-project-cmd": [
        "@php artisan key:generate"
    ],
    "post-install-cmd": [
        "Illuminate\\Foundation\\ComposerScripts::postInstall",
        "@php artisan optimize",
        "mkdir -p storage/framework/{views,cache,sessions,testing}",
        "touch storage/framework/views/.gitkeep",
        "touch storage/framework/cache/.gitkeep",
        "touch storage/framework/sessions/.gitkeep",
        "touch storage/framework/testing/.gitkeep"
    ]
}

This ensures the required directories are created right after Composer installs your dependencies during deployment.

Since you’re using Laravel 5.8, all these steps are fully compatible. After implementing these changes, redeploy your project to GCP and the cache path error should be resolved.

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