答案是：先确认.env文件存在且含有效app_key（base64:开头的32位字符串），若缺失则运行php artisan key:generate生成；若已存在但报错，需依次执行php artisan config:clear和php artisan config:cache刷新配置缓存。
.env 文件缺失或 APP_KEY 为空
这是最常见原因：新项目没生成密钥，或手动删了 .env 里的 APP_KEY 行。Laravel 启动时读不到有效密钥，直接抛出 RuntimeException: No application encryption key has been specified。
检查步骤：
- 确认项目根目录存在
.env文件；若只有.env.example，先复制并重命名为.env - 打开
.env，确认APP_KEY=后面有 32 位随机字符串（如base64:qJ+...），不能留空或只写APP_KEY= - 如果
APP_KEY为空，运行php artisan key:generate—— 它会自动生成并写入.env
config 缓存未更新导致 .env 不生效
即使 .env 里已有正确 APP_KEY，Laravel 仍报错，大概率是 config 缓存没刷新。因为 php artisan config:cache 会把配置固化成 PHP 文件，之后不再读 .env；但如果你改了 .env 却没清缓存，旧缓存还在用空密钥。
必须按顺序执行：
-
php artisan config:clear—— 清掉旧的缓存配置 -
php artisan config:cache—— 重新从.env生成缓存 - 注意：不要只清
cache:clear，它不清理 config 缓存
phpunit 测试时单独报错
运行 ./vendor/bin/phpunit 报这个错，但 Web 正常？问题在 phpunit.xml 的环境隔离。默认它设 APP_ENV=testing，而 Laravel 的 testing 环境不会自动加载 .env，除非你显式配置。
解决方法：
- 打开
phpunit.xml，找到<php></php>节点 - 添加一行：
<env name="APP_KEY" value="base64:your_actual_app_key_here"></env>（值要和.env里一致） - 或者临时改成
<env name="APP_ENV" value="local"></env>，让测试走本地环境逻辑（仅开发调试用）
APP_KEY 被意外覆盖或格式错误
有些部署脚本、Dockerfile 或 CI 流程会动态写入 APP_KEY，但可能漏了 base64 前缀，或用了含换行/空格的密钥，导致解析失败。
验证方式：
- 在
.env中检查APP_KEY是否以base64:开头（Laravel 5.6+ 强制要求） - 运行
php artisan tinker，输入echo config('app.key');—— 如果输出null或空字符串，说明密钥根本没加载成功 - 避免手动编辑
config/app.php中的'key'字段：Laravel 5.5+ 已弃用该方式，只认.env里的APP_KEY
.env → 生成密钥 → 清 config 缓存 → 重缓存。最容易卡住的是第三步——很多人以为清了缓存就完事，却忘了 config 缓存要单独处理，而且必须清完再重生成。
