Laravel运行Artisan报错求助：新手接手旧项目无法启动

作为踩过无数Laravel旧项目坑的开发者，我来帮你一步步捋清楚问题所在😉

第一步：补全Composer依赖安装 #

你提到执行了Composer安装命令，但大概率只是装了Composer本身，还没安装项目的依赖包。先确认你的WAMP PHP版本和项目要求匹配（看项目根目录composer.json里的require字段），然后在项目目录下执行：

composer install

如果Windows下遇到权限报错，记得右键cmd选择「以管理员身份运行」再执行。

第二步：配置环境文件与应用密钥 #

Laravel没有.env文件根本跑不起来，旧项目一般会自带.env.example模板：

1. 复制.env.example并重命名为.env
2. 修改.env里的数据库配置，匹配你的WAMP/phpMyAdmin：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=旧项目对应的数据库名
DB_USERNAME=root（WAMP默认用户名）
DB_PASSWORD=你的数据库密码（没设置就留空）

3. 生成应用密钥（这步必须做）：

php artisan key:generate

第三步：导入旧项目数据库 #

旧项目肯定有对应的SQL备份：

1. 打开phpMyAdmin，创建一个和.env里DB_DATABASE同名的数据库，字符集选utf8mb4（Laravel默认适配）
2. 导入旧项目的SQL备份文件，若导入报错，检查备份文件的字符集是否和数据库一致

第四步：调整WAMP虚拟主机配置 #

直接用localhost/项目名访问容易出路径问题，建议配置虚拟主机：

1. 打开WAMP的Apache虚拟主机配置文件（路径一般是wamp64/bin/apache/apacheX.X.X/conf/extra/httpd-vhosts.conf）
2. 添加以下配置（替换成你的项目路径）：

<VirtualHost *:80>
    ServerName old-project.local
    DocumentRoot "C:/wamp64/www/old-project/public"
    <Directory "C:/wamp64/www/old-project/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

3. 修改系统hosts文件（C:\Windows\System32\drivers\etc\hosts），添加一行：

127.0.0.1 old-project.local

4. 重启WAMP的Apache服务，用old-project.local访问项目

第五步：通过错误日志定位问题 #

如果以上步骤都没用，直接看日志找线索：

• Laravel应用日志：项目根目录/storage/logs/laravel.log，里面会记录具体报错（比如数据库连接失败、依赖缺失）
• WAMP Apache日志：wamp64/logs/apache_error.log，排查Web服务器层面的问题

旧项目大概率是依赖版本、环境配置或数据库的问题，按这个顺序排查基本能解决。

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