Laravel通过artisan down命令启用维护模式,显示503页面并支持自定义消息、重试时间及允许特定IP访问,使用artisan up命令恢复服务,提升系统升级时的用户体验。

Laravel 提供了简单的方式来将应用置于维护模式,这在进行系统升级、数据库迁移或临时停机维护时非常有用。启用维护模式后,所有进入的请求都会显示一个统一的“维护中”页面,避免用户访问到不稳定的功能。
使用 Artisan 命令启用维护模式
Laravel 内置了 down 命令,可快速开启维护模式:
artisan down执行后,应用会自动返回 503 Service Unavailable 状态码,同时展示 resources/views/errors/503.blade.php 页面(若不存在则使用默认模板)。
自定义维护模式响应内容
你可以通过参数自定义维护页面的标题和消息:
artisan down --message="系统升级中" --retry=60- --message:设置提示信息
- --retry:指定客户端多久后重试(单位为秒)
- 还可添加 --allow=192.168.0.1 允许特定 IP 访问(如管理员调试)
禁用维护模式
维护完成后,使用以下命令恢复服务:
artisan up该命令会移除存储在 storage/framework/down 的状态文件,恢复正常路由处理。
手动触发维护逻辑(可选)
你也可以在代码中判断是否处于维护模式:
if (app()->isDownForMaintenance()) { // 自定义逻辑,如返回 JSON 提示 }基本上就这些。合理使用维护模式能提升用户体验,避免用户在更新期间遇到错误。记得维护结束后及时执行 up 命令恢复服务。










