Laravel项目部署核心在于路由、模型、视图解耦及数据库交互可控，而非仅搭环境；必须立即执行三件事：复制.env.example为.env、运行php artisan key:generate、清空config与cache缓存，否则加密失效、配置不生效、上线后频繁报错。
Laravel项目不是“搭完环境就能跑”，核心在于路由、模型、视图三者是否真正解耦，以及数据库交互是否可控。盲目照搬教程建完 CRUD 就以为是实战，上线后查个列表卡两秒、改个配置全站报错，问题基本都出在初始化阶段的几个关键动作没做对。
laravel new 之后必须立刻执行的三件事
刚用 composer create-project laravel/laravel myapp 拉完代码，别急着写控制器——先稳住底座：
- 立刻复制
.env.example为.env，然后运行php artisan key:generate；缺这步会导致所有加密/Session 功能失效，且错误不报在日志里，只表现为登录态丢失或 CSRF 失败 - 确认
APP_URL和DB_*配置项已填，尤其是DB_PORT：MySQL 默认是3306，但宝塔或 Docker 环境常映射成3307或其他端口，连不上库时第一反应不该是“密码错”，而是检查这个端口 - 运行
php artisan config:clear和php artisan cache:clear；Laravel 8+ 默认启用配置缓存，本地改了.env不清缓存根本不会生效，现象就是死活读不到新 DB 密码
routes/web.php 里别直接写逻辑
新手常把表单处理、数据校验、重定向全塞进路由闭包，看似快，实则不可测、不可复用、后期加中间件（如权限）时要重写一遍：
- 所有带业务逻辑的 GET/POST 路由，必须指向控制器方法，哪怕只是
IndexController@index；命令行快速生成：php artisan make:controller IndexController --invokable - 表单提交一律用
POST+@csrf，别用 GET 传敏感参数；Laravel 对 GET 请求默认不校验 CSRF，但一旦你后面加了VerifyCsrfToken中间件，所有未带 token 的 POST 就全 419 - 重定向不要写
return redirect('/success')，改用命名路由：return redirect()->route('success.page')；否则后期改 URL 路径时，得全局搜字符串，极易漏掉
Model 关联查询必须显式 select 字段
with() 不是银弹，不加约束的预加载在百万级数据下会直接拖垮内存和网络传输：
-
Post::with('user')->get()实际执行两条 SQL，但第二条是SELECT * FROM users WHERE id IN (1,2,3...)，哪怕你页面只显示用户名，也把用户头像、密码哈希、remember_token 全捞回来了 - 正确写法是绑定字段选择：
Post::with(['user' => fn ($q) => $q->select('id', 'name', 'avatar')])->get()；注意关联表的id必须包含，否则 Eloquent 关联映射失败 - 如果主表也要精简字段，必须同时用
select()：Post::select('id', 'title', 'user_id')->with(...)->get()；漏掉外键字段（如user_id）会导致关联为空
部署到宝塔前务必关掉 debug 模式
本地开发开着 APP_DEBUG=true 没问题，但只要放上服务器，就必须设为 false，否则：
- 任意一个 500 错误都会把完整堆栈、.env 内容、SQL 查询原样吐给前端，等于把数据库密码贴在首页
- 宝塔面板的 PHP 错误日志会疯狂刷屏，特别是遇到 N+1 查询时，一条请求可能记几百行 SQL，几小时就撑爆磁盘
- 某些扩展（如 Debugbar）在
APP_DEBUG=true下自动加载，而宝塔默认没装这些扩展，导致Class not found报错，但错误信息被隐藏，只看到白屏
真正卡住多数人的从来不是“怎么写功能”，而是 .env 没生效、config:cache 没清、关联字段漏了 id、部署时忘了关 debug —— 这些点不手动验证一遍，项目越往后越难排查。
