Laravel部署到 Linux 服务器怎么做-Laravel-PHP中文网

laravel部署失败90%因public目录未被web服务器正确指向或.env缺失/权限错误：nginx/apache的root必须设为项目内public绝对路径，.env需存在且执行php artisan key:generate生成app_key，storage与bootstrap/cache须赋予web用户读写权限。

laravel部署到 linux 服务器怎么做

直接上结论：Laravel 部署失败，90% 是因为 public 目录没被 Web 服务器正确指向，或者 .env 缺失/权限不对。不是代码问题，是路径和权限卡住的。

Web 服务器 root 必须指向 public 目录

Nginx 或 Apache 的配置里，root（Apache 是 DocumentRoot）必须明确写成项目内 public 文件夹的绝对路径，不能指向项目根目录。否则所有请求都进不到 Laravel 的前端控制器，直接 404 或下载 index.php 源码。

常见错误：

配成了 /data/wwwroot/laravel（项目根），而不是 /data/wwwroot/laravel/public
宝塔面板里“网站目录”填对了，但“运行目录”没设成 public（这个选项默认是空的，容易漏）
用软链接替换 public，但没在 Nginx 里加 follow_symlinks on;（Nginx 默认不追踪符号链接）

正确示例（Nginx）：

server {
    listen 80;
    server_name example.com;
    root /data/wwwroot/laravel/public;  # ← 这行必须带 /public
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

.env 文件和 APP_KEY 缺一不可

上传完代码后，.env 文件必须存在且可读；如果用 cp .env.example .env 创建，还得立刻生成密钥，否则会报 Missing application key 错误，页面白屏或 500。

操作顺序不能错：

进入项目根目录：cd /data/wwwroot/laravel
复制环境文件：cp .env.example .env
生成密钥：php artisan key:generate（注意：必须在项目根目录下执行）
检查 .env 里 APP_KEY 是否已写入（不是空值）

如果提示 command not found: artisan，说明当前用户没权限执行 PHP 或 Composer 未安装——先确认 php -v 和 composer --version 能正常输出。

onewo-rtlinux

Linux 实时编程助手。生成、审查并修改用于周期性控制任务和中断驱动程序的 C 代码。强制实施实时调度策略。

下载

storage 和 bootstrap/cache 权限要放开

Laravel 运行时要往 storage 写日志、缓存、session，还要往 bootstrap/cache 写配置缓存。如果权限不足，就会出现「无法写入日志」「缓存生成失败」「登录态丢失」等看似随机的问题。

别直接 chmod -R 777 storage（不安全），推荐最小权限方案：

chown -R www-data:www-data storage bootstrap/cache（Ubuntu/Debian，Web 用户通常是 www-data）
chown -R apache:apache storage bootstrap/cache（CentOS/RHEL，Web 用户是 apache）
再补一句：chmod -R 755 storage bootstrap/cache

验证是否生效：手动触发一次日志写入，比如访问一个不存在的路由，然后看 storage/logs/laravel.log 是否有新内容。