Laravel 10 + React + Inertia.js项目运行npm run dev引发种子数据丢失及样式异常

一、种子数据消失的排查方向 #

• 检查package.json的scripts配置：确认dev命令是否绑定了自动重置数据库的脚本，比如是否写成了类似"dev": "php artisan migrate:fresh --seed && vite"的形式，这种会在启动热重载时自动清库重seed。
• 核对.env环境配置：确认APP_ENV=local而非testing，同时检查DB_DATABASE是否指向你正在使用的开发数据库——测试环境通常会自动重置数据。
• 检查Vite/Inertia的服务端钩子：查看vite.config.js或Laravel端的vite.config.php，是否存在自定义的服务器启动钩子（比如server.fs.watch触发的脚本），或是Inertia服务提供者中存在热重载时触发数据重置的逻辑。
• 清除Laravel配置缓存：执行php artisan config:clear和php artisan cache:clear，缓存的配置可能导致实际连接的数据库与预期不符。

二、样式意外变化的排查方向 #

• 检查样式导入路径：确认CSS/Sass文件的相对导入路径是否正确，或是Vite的resolve.alias配置是否有误，导致热重载时样式文件无法正确解析， fallback到默认样式。
• 清除Vite编译缓存：删除node_modules/.vite目录后重启npm run dev，损坏的编译缓存可能导致样式渲染异常。
• 排查样式隔离问题（React环境）：如果使用CSS Modules，确认类名是否正确绑定；如果用全局样式，检查是否存在热重载时旧样式未被清除、新样式未正确注入的情况。
• 核对Vite热重载配置：查看vite.config.js中是否禁用了样式热重载，或是配置了错误的热重载规则，导致样式无法正常更新。

三、通用修复步骤 #

1. 先备份当前数据库，避免数据丢失。
2. 执行全量缓存清理：

   php artisan config:clear
   php artisan cache:clear
   php artisan view:clear
   rm -rf node_modules/.vite
   npm cache clean --force
   

3. 重新安装依赖：npm install
4. 重新填充种子数据：php artisan db:seed
5. 分开启动服务：先单独运行php artisan serve，再启动npm run dev，排除命令绑定导致的联动问题。

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