Laravel 8部署后注册新用户提示users表不存在问题排查求助

Table users doesn't exist错误的核心是Laravel运行时连接的数据库中不存在users表，结合提供的代码和操作步骤，可能的原因及对应解决方法如下：

可能的原因 #

• 数据库迁移未实际执行成功：通过路由调用artisan命令无法直观看到执行报错，可能迁移过程中出现权限不足、文件名不符合规范等问题，导致users表未创建
• 配置缓存导致连接错误：若曾执行过php artisan config:cache，后续修改的.env数据库配置不会生效，Laravel可能连接到了其他没有users表的数据库
• 表前缀配置不匹配：若config/database.php中配置了数据库表前缀，迁移生成的表会自动带上前缀，若配置变更前后前缀不一致，会导致Laravel找不到对应表
• User模型表名配置异常：若曾在User模型中自定义过$table属性，后续删除后未清理缓存，会导致Laravel依然读取错误的表名

分步解决方法 #

1. 先手动确认目标库表存在情况
   使用数据库管理工具直接连接.env中配置的pkme1826_pkmtest库，查看是否存在users表，若不存在直接进入迁移排查步骤。
2. 排查迁移执行问题
   • 不要通过路由调用artisan命令，直接在项目根目录执行命令行操作：
   • 执行php artisan migrate:status，查看create_users_table对应的状态，若为No则表示该迁移未执行
   • 执行php artisan migrate，根据命令行输出的报错信息处理问题：如果是权限不足则给数据库账号授予建表权限，如果是迁移文件名不规范则将文件名调整为YYYY_MM_DD_六位数字_create_users_table.php的标准格式
3. 清理配置缓存确认连接正确
   • 执行php artisan config:clear清除配置缓存
   • 执行php artisan tinker，输入config('database.connections.mysql.database')，确认输出为pkme1826_pkmtest，同时检查config('database.connections.mysql.prefix')的前缀配置是否和数据库中实际表前缀一致
4. 修正代码其他已知问题（不影响当前报错，但会导致后续逻辑异常）
   • User模型中ketua方法存在笔误，将hesOne修改为hasOne
   • 修改后的store方法同时使用了实例化赋值保存和User::create两种写入逻辑，会导致重复插入两条用户数据，保留其中一种即可
   • 若请求参数中用户名字段为nama，需要同步修改User模型$fillable属性和迁移文件中的name字段为nama，保证字段名一致

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