ThinkPHP跨平台模型开发：Windows与Linux下数据库表名大小写避坑【说明】

踩过这个坑的人可能还记得——Windows开发环境里跑得好好的ThinkPHP项目，一部署到Linux服务器就开始疯狂报错“Table 'xxx' doesn't exist”。别急着修代码，问题多半出在数据库表名的大小写处理上：Windows默认不敏感，Linux默认敏感，而ThinkPHP的Db::name()和模型类压根不会帮你转换标识符的原始形态。

根本原因是Linux下MySQL/Kingbase默认大小写敏感，而Windows不敏感；MySQL需设lower_case_table_names=1（空库时生效），Kingbase必须初始化时加--enable-ci重建数据库，show enable_ci返回off且日志报unrecognized即未启用。

所以，解决问题的关键在于先摸清数据库当前的“脾气”，再对症下药。

确认当前数据库是否启用大小写不敏感模式

登录数据库，执行对应命令：MySQL用show lower_case_table_names;，KingbaseV8用show enable_ci;。

MySQL返回1表示已启用不敏感模式；Kingbase如果返回off且日志提示unrecognized configuration parameter "enable_ci"，说明实例初始化时没加--enable-ci参数——重建数据库是唯一生效方式。千万别试图在kingbase.conf里手动加enable_ci = on，运行时根本不起作用，重启后照样报错。

ThinkPHP模型层统一规避大小写断裂

搞清楚了底层状态，再针对不同场景选方案。

方法一：强制指定小写表名（推荐用于新项目）
在模型类中显式声明protected $table = 'userinfo';，全部使用小写字母+下划线，禁止用双引号包裹任何SQL标识符。这样无论底层是否敏感，代码都能稳定匹配。

方法二：适配已有大写建表（仅限MySQL，且lower_case_table_names=1）
如果现有的表名已经包含大写字母，并且你用的是MySQL，可以修改配置文件my.cnf，在[mysqld]节点下添加lower_case_table_names=1，然后重启服务。但这条命令必须在数据库为空时执行，否则可能引起元数据损坏，老项目慎用。

方法三：KingbaseV8专用补救（无法改配置时）
如果Kingbase实例无法重建，可以在模型中覆盖parseTable方法：protected function parseTable($table) { return strtolower($table); }。这条路只影响当前模型的FROM子句，JOIN、子查询、字段别名等场景依然会踩坑——算是一个“半残”方案，能不用尽量不用。

Linux部署前必须完成的三步检查

方案定下来之后，上生产前务必走一遍这三步，能省掉99%的线上排查时间。

第一步：检查所有Db::name()调用中的字符串字面量
确保全是小写，比如Db::name('user_log')，禁止出现Db::name('UserLog')或Db::name('USER_LOG')。这是个习惯问题，但老项目里遗留的大写调用经常是bug的源头。

第二步：比对数据库实际表名与模型中$table值
执行SELECT table_name FROM information_schema.tables WHERE table_schema = 'your_db_name';，把结果和模型里声明的表名逐字符对比，包括大小写。差一个字母都可能触发“不存在”错误。

第三步：在Linux服务器上用命令行直连验证
运行mysql -u root -p -e "use your_db; show tables;"，看终端输出的表名是否和代码中使用的完全一致。这一步能绕开所有IDE或ORM的缓存，直接测试裸数据库的原始输出。