Linux环境启动PHP Laravel项目报Server 500错误求助

核心原因 #

报错本质是缺失Laravel必备的环境配置文件.env，该文件包含项目运行需要的所有敏感配置（加密密钥、数据库密码等），Laravel官方默认会将该文件加入.gitignore规则，因此Git仓库不会同步该文件。

完整解决步骤 #

• 第一步：从项目自带的模板复制生成.env文件
  Linux/Mac环境执行：
  cp .env.example .env
  Windows cmd环境执行：
  copy .env.example .env
• 第二步：生成应用加密密钥
  执行命令后会自动将生成的密钥写入.env文件的APP_KEY字段，解决密钥缺失报错：
  php artisan key:generate
• 第三步：调整适配本地环境的配置（按需操作）
  打开.env文件修改对应配置即可，仅测试基础运行可跳过该步骤：
  • 数据库相关配置：DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD
  • 其他服务配置：REDIS_HOST、REDIS_PORT、MAIL_HOST等
• 第四步：执行项目初始化命令（按需操作）
  如果项目需要用到数据库、前端资源，执行对应命令：
  • 执行数据库迁移：php artisan migrate
  • 编译前端静态资源：生产环境用npm run build，开发环境用npm run dev
  • 清理旧缓存避免配置冲突：php artisan config:clear
• 第五步：重启服务
  php artisan serve
  重启后访问127.0.0.1:8000即可正常访问项目。

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