ThinkPHP Windows升级白屏等根本原因是系统底层差异：PHP扩展路径需双反斜杠且绝对、类名与文件名大小写必须严格一致、.env须UTF-8无BOM、定时任务起始路径要设为项目根而非public、runtime需赋予IIS_IUSRS或Apache用户修改权限。
Windows环境升级ThinkPHP时，常出现白屏、500错误、类找不到、定时任务静默失败等问题，根本原因不是框架代码差异，而是Windows与Linux在文件系统、PHP运行模式、路径解析、扩展加载机制上的底层分歧。
PHP扩展加载路径不一致
Windows下必须手动在php.ini中显式启用扩展，且extension_dir路径需绝对、无空格、反斜杠要双写；Linux下多数包管理器自动注册扩展，路径由系统动态推导。
打开C:php8php.ini，确认以下四行已取消注释并路径正确：
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=fileinfo
【extension_dir = "C:\php8\ext"】——Windows要求双反斜杠，漏掉一个或写成正斜杠都会导致所有扩展加载失败，但php -m仍显示模块名（伪成功），实际运行时报Class not found。
立即学习“PHP免费学习笔记（深入）”；
执行php -m | findstr "mbstring openssl"验证CLI是否真加载；再用phpinfo()页面核对Web SAPI加载状态，两者不一致说明Apache/Nginx用了另一份php.ini。
路径大小写敏感性引发的连锁报错
ThinkPHP 6+ 在Windows下运行时，控制器类名IndexController对应文件必须是IndexController.php，而非indexcontroller.php——虽然Windows能读取小写文件名，但spl_autoload_register()按类名精确匹配路径，大小写不一致直接触发“Class not found”。
第一步：进入app/controller/目录，用PowerShell执行Get-ChildItem | Where-Object {$_.Name -cne $_.Name.ToLower()}，列出所有首字母大写的文件名。
第二步：检查每个控制器类定义，确认class名与文件名完全一致（包括大小写、驼峰规则）。
第三步：全局搜索模板引用{include file="xxx/yyy"}，把所有路径统一改为小写，例如{include file="common/header"}，避免Linux部署后模板失效。
注意：不要用strtolower()包裹路径做兼容——这会让Linux下原本正确的路径因强制转小写而404。
定时任务在Windows无法触发
方法一：用Windows计划任务调用php.exe执行命令
新建基本任务→触发器设为每天/每小时→操作选“启动程序”→程序填C:php8php.exe，参数填D: p8publicindex.php，起始于填D: p8public
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
方法二：改用CLI模式直调控制器（推荐）
将Fastadmin或自定义定时任务控制器中的isCli()判断保留，删除Web访问拦截逻辑，然后在计划任务中参数改为：-f D: p8 hink task/run
【计划任务“起始于”必须填项目public目录的父级，即D: p8，不能填D: p8public】——否则think命令找不到应用根目录，报“Application not found”。
方法三：用第三方工具如nssm把php think run封装为Windows服务，但需额外配置stdout重定向，否则日志无法捕获。
.env文件编码和加载时机差异
Windows记事本默认保存为UTF-8 with BOM，ThinkPHP的Dotenv组件读取时会把BOM当字符解析，导致APP_DEBUG=false被识别为APP_DEBUG=false，env()返回null或false。
用VS Code或Notepad++打开.env，编码菜单选“UTF-8无BOM”，保存后重启Web服务。
检查入口文件public/index.php，确认Dotenv::createImmutable(__DIR__.'/..')->load()调用位于require __DIR__.'/../thinkphp/start.php';之前——位置颠倒会导致.env未加载就进入框架初始化，config()里所有env()值均为null。
Linux下通常用systemd或supervisord管理进程，.env权限需设为644且属主为www-data；Windows下IIS或Apache以SYSTEM身份运行，.env放任何位置都可读，但BOM问题更致命。
runtime目录权限与缓存行为
Windows下runtime目录需继承父目录的“修改”权限，否则日志写入失败、模板缓存生成报错，但错误不抛出，只静默跳过。
右键runtime文件夹→属性→安全→编辑→添加IIS_IUSRS或Apache用户→勾选“修改”“写入”→确定。
ThinkPHP 8默认开启配置缓存，runtime/config.php是编译后快照；Windows下若用资源管理器直接删runtime，部分文件可能被占用删不掉，此时需先停止Apache服务再删除。
开发期临时禁用缓存：在app.php中设'config_cache_on' => false，避免改了.env或database.php却看不到效果。
