ThinkPHP 启动报错“ParseError: syntax error, unexpected token 'string'”是因PHP版本过低（需8.0+），宝塔默认设为7.4易踩坑；应切换PHP版本至8.0或8.1并重载配置。
ThinkPHP 启动报 ParseError: syntax error, unexpected token "string"
这是 PHP 版本太低的典型表现，常见于宝塔面板里站点 PHP 版本被设为 7.3 或更低，而 ThinkPHP 6.1+ 要求最低 PHP 8.0（因用了 PHP 8.0 的命名参数、联合类型等语法）。宝塔默认新建站点常配 7.4，极易踩坑。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进宝塔 → 网站 → 选中站点 → 设置 → PHP 版本 → 切换为
8.0或更高（推荐8.1，兼顾兼容与性能） - 切完别急着刷新页面，先点“重载配置”或重启对应 PHP 服务（宝塔右上角“软件管理”→ 找到对应 PHP → “重载配置”）
- 确认生效：在站点根目录放一个
phpinfo.php，内容为<?php phpinfo(); ?>，浏览器访问验证PHP Version行
宝塔里启用 opcache 后 ThinkPHP 路由 404 或白屏
ThinkPHP 的自动路由和反射机制高度依赖文件实时读取，而 opcache.enable=1 且未禁用脚本校验时，会缓存旧的类定义或路由映射，导致控制器找不到、中间件不触发等问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进宝塔 → 软件管理 → 找到当前 PHP 版本 → 设置 → 配置修改 → 搜索
opcache.revalidate_freq，改为0（强制每次请求校验文件修改时间） - 同时确保
opcache.validate_timestamps=1（默认开启，但有些宝塔模板会误关） - 开发阶段可直接关闭 opcache：
opcache.enable=0，上线再开；切勿在 .env 或 runtime 中试图绕过——那是徒劳
pdo_mysql 扩展已安装但 ThinkPHP 报 Driver [mysql] not supported
不是扩展没装，而是宝塔给不同 PHP 版本装了不同扩展路径，ThinkPHP 运行时加载的是另一个 PHP 实例的配置。尤其多版本共存时（如站点用 8.1，但宝塔后台用 7.4），php -m 查到的扩展≠站点实际加载的扩展。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在 ThinkPHP 项目根目录建
test_ext.php，内容为<?php var_dump(extension_loaded('pdo_mysql'));，用浏览器访问该文件，看输出是否为bool(true) - 如果为
false，进宝塔 → 软件管理 → 对应 PHP 版本 → 安装扩展 → 勾选pdo_mysql（注意：必须选中当前站点所用的 PHP 版本，不是系统默认那个） - 扩展名大小写敏感：
PDO_mysql或pdo-mysql都无效，必须是pdo_mysql
宝塔伪静态规则写错导致 ThinkPHP index.php 强制暴露
ThinkPHP 默认依赖 URL 重写隐藏 index.php，宝塔 Nginx 面板里选“ThinkPHP”伪静态只是基础模板，若项目入口不在根目录（比如部署在 /sub/ 下），或用了子域名绑定二级应用，原规则会失效，所有 URL 都带 index.php。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进宝塔 → 网站 → 设置 → 伪静态 → 选“ThinkPHP”，然后手动补全
root路径：把try_files $uri $uri/ /index.php$uri;改成try_files $uri $uri/ /sub/index.php$uri;（/sub/替换为你的实际子目录） - Apache 用户注意：
.htaccess文件必须放在项目根目录，且宝塔需开启“启用 Apache 伪静态”（网站设置 → 网站目录 → 勾选“启用 Apache 伪静态”） - 改完务必点“保存”，再点“重载配置”，Nginx 不会自动热加载 rewrite 规则
最麻烦的其实是 PHP 版本、opcache、扩展、伪静态这四者之间的隐式耦合——改一个，另外三个可能悄悄失效。调试时别只盯日志，一定要用 phpinfo() 和 var_dump(extension_loaded()) 这类最笨但最准的方式交叉验证。
