Laravel 8 本地运行报Unsupported SSL request报错解决
报错核心成因
php artisan serve启动的Laravel内置开发服务默认仅提供HTTP访问能力,本身不具备SSL加密请求的处理能力- 部分早期开源Laravel项目(包括你克隆的goodwork项目)在源码中预置了无环境判断的HTTPS强制跳转逻辑,初始访问首页时未触发跳转判断,手动输入HTTP地址可正常打开页面;点击登录按钮后,程序自动将链接协议拼接为HTTPS,请求直接发往纯HTTP服务端口,就会触发
Unsupported SSL request报错 - 通用网络修复方案大多适配生产环境Nginx/Apache反向代理、Web服务部署场景,直接应用在本地内置开发服务上,无法触达实际的跳转逻辑触发点,因此修复效果失效
分步操作修复方案
- 定位项目内的强制HTTPS逻辑入口
全局搜索项目代码中forceScheme、强制跳转HTTPS的相关实现,这类逻辑通常会写在app/Providers/AppServiceProvider.php的boot方法,或是全局路由中间件中。典型问题来源:为了适配线上HTTPS部署环境,代码中直接无判断地写了
URL::forceScheme('https'),开发环境下也会触发强制协议跳转。 - 调整强制HTTPS的生效范围
将全局写死的HTTPS强制逻辑,修改为仅在生产环境生效,开发环境下直接跳过强制跳转。参考配置如下:// app/Providers/AppServiceProvider.php 内boot方法的参考写法 public function boot() { // 仅生产环境开启HTTPS强制 if (app()->environment('production')) { \Illuminate\Support\Facades\URL::forceScheme('https'); } } - 清理历史缓存配置
代码修改完成后,依次执行以下命令清除旧的配置、路由、视图缓存,避免缓存残留的旧逻辑持续触发:php artisan config:clearphp artisan route:clearphp artisan view:clear
- 服务重启验证
重新执行php artisan serve启动服务,访问HTTP本地地址,点击登录按钮确认页面不会自动跳转HTTPS,请求可正常处理。 - 临时替代测试方案
如果需要在本地测试HTTPS流程,不需要修改强制跳转逻辑,可直接使用PHP内置的TLS模式启动服务:执行php artisan serve --tls,访问命令行输出的对应HTTPS本地地址,即可正常处理HTTPS请求,不会触发SSL不支持的报错。
内容的提问来源于stack exchange,提问作者Kameam
相关产品推荐
相关产品推荐

