ThinkPHP项目从Windows迁移到Linux会因路径分隔符、大小写敏感、扩展行为差异、文件权限等底层差异导致加载失败、SSL错误、时区异常、runtime不可写、.env读取失败及脚本执行报错。
ThinkPHP项目从Windows迁移到Linux时，表面只是换台服务器，实际会触发多层隐性兼容问题——路径分隔符、大小写敏感、扩展行为差异、文件权限机制等底层差异，会让原本在Windows下稳如泰山的代码，在Linux上直接报错或静默失败。
路径与文件系统差异引发的加载失败
Windows不区分大小写，app\index\controller\Index.php 和 APP\INDEX\CONTROLLER\INDEX.PHP 都能被自动识别；Linux则严格区分。常见故障包括：
- 控制器类找不到：命名空间写成
app\index\controller\Index，但文件实际为index.php（小写），而Linux下无法匹配大写的Index.php - 模板路径错误：Windows下
view/index/index.html和VIEW/INDEX/INDEX.HTML都可渲染，Linux中必须完全一致 - vendor/autoload.php 加载失败：某些自定义类库在
composer.json的autoload.files中写了带 Windows 路径风格的引用（如./extend/helper.php），Linux下因路径解析逻辑不同导致跳过加载
PHP扩展与配置项的行为偏移
同一扩展在不同系统下表现可能不同，尤其涉及I/O、编码、时区等场景：
-
mbstring：Windows版PHP常默认启用
mbstring.func_overload=2，掩盖了部分字符串函数（如substr）对UTF-8处理不当的问题；Linux默认关闭该选项，迁移后中文截取突然出错 -
file_get_contents + HTTPS：Windows下cURL常通过WinSSL工作，对证书链宽松；Linux若未配置
openssl.cafile或 ca-bundle.crt 路径，调用第三方API直接抛出SSL error -
date.timezone：Windows php.ini 中可能设为
Asia/Shanghai，但Linux发行版（如Ubuntu）默认无此时区软链，需手动执行sudo dpkg-reconfigure tzdata或设置环境变量export TZ=Asia/Shanghai
运行时权限与目录结构陷阱
Linux对文件所有权和权限更敏感，ThinkPHP默认目录结构在无干预下极易触发500错误：
立即学习“PHP免费学习笔记（深入）”；
-
runtime/ 目录不可写：Apache/Nginx进程用户（如
www-data或nginx）无权写入，日志、缓存、模板编译全部失败，页面空白且无报错提示 -
public/ 以外的目录被Web服务误暴露：Nginx配置若未限制
location ~ ^/(application|config|route|app)/，可能导致源码泄露 -
.env 文件权限过高：Linux下若设为
644，部分PHP版本会因安全策略拒绝读取，需改为600并确认Web用户是文件所有者
命令行与部署脚本失效
Windows下惯用的批处理、路径硬编码、回车符（CRLF）在Linux CLI中直接失灵：
-
php think optimize:route报错Could not open input file: think：因Linux不识别tp.bat，且项目根目录未正确进入（尤其用宝塔或Docker挂载时路径易错位） - CI/CD脚本含
copy、del命令或%cd%变量，迁移到Linux后需重写为cp、rm、$(pwd) - Git提交的文件含CRLF换行符，Linux下shell脚本执行报
^M: command not found，需统一转LF（dos2unix或 Git全局设置core.autocrlf=input）
