ThinkPHP 8.1 多站点成功运行的核心是三件事：正确初始化多应用结构（删app/controller、用php think build创建子应用）、精准绑定二级域名或路径（domain_bind键需与HTTP_HOST完全一致且DNS可解析）、Web服务器配置不越界（root指向public、Nginx用try_files规则、禁用TP6伪静态）。
ThinkPHP 8.1 多站点不是靠“装个插件”就能跑通的，核心在于三件事：正确初始化多应用结构、二级域名或路径路由精准绑定、Web 服务器入口和重写规则不越界。漏掉任何一环，都会出现 404、APP_PATH 错乱、session 串用或后台路由进前台等问题。
用 composer create-project 初始化项目时必须加参数
直接运行 composer create-project topthink/think tp81 会拉到不稳定分支或缺失关键文件（比如 public/index.php 权限异常、.env 未生成）。实际项目中踩坑最多的是调试关闭导致错误不显示，以及 vendor 内残留 .git 引发后续部署冲突。
- 必须加上
--stability=stable --remove-vcs：确保拉取稳定版且清理 Git 元数据 - 一定不要加
-n：否则跳过.env初始化，APP_DEBUG=false默认生效，所有报错静默吞掉 - Windows 用户检查
php.ini中extension=openssl是否启用（常被注释）；Linux 用户要确认 CLI 和 Web 服务用的是同一份配置——用php -i | grep "Configuration File"查 CLI 路径，再对比phpinfo()页面里的Loaded Configuration File
安装 think-multi-app 后必须删掉 app/controller
这是最常被忽略的一步。TP8.1 的多应用模式下，app/controller 是单应用残留目录，它会干扰路由识别逻辑，导致访问 admin.tp81.com 时仍匹配到 index 应用的控制器。
- 执行
composer require topthink/think-multi-app后，立刻运行rm -rf app/controller（Windows 可手动删除该文件夹） - 再用
php think build index和php think build admin创建两个应用，此时app/index/和app/admin/才是唯一有效的入口 - 别手欠复制旧项目的
app/common.php或app/middleware.php过来——多应用下这些文件应放在各子应用目录内，全局放会引发中间件重复注册或配置覆盖
Nginx 配置必须指向 public/ 且重写规则不能套用 TP6 模板
很多教程直接把 TP6 的伪静态规则粘过来，但 TP8.1 的路由解析机制已变化：$query_string 不再参与 s= 参数拼接，硬套会导致所有带参数的 URL（如 /admin/login?redirect=/dashboard）丢失 query 部分。
立即学习“PHP免费学习笔记（深入）”；
- 网站根目录必须设为
/path/to/public，不是项目根目录；宝塔用户在【网站设置】→【网站目录】里改「运行目录」为/public - Nginx 的
location /块必须用try_files $uri $uri/ /index.php?$query_string;，不是rewrite ^(.*)$ /index.php?s=$1 last; - 若用二级域名（如
admin.tp81.com），Nginx server 块里root仍指向项目public/，不要为每个子站单独配 root ——TP8.1 靠domain_bind在 PHP 层完成分发，Web 层只做统一入口转发
config/app.php 里 domain_bind 的键名必须可 DNS 解析
开发阶段很多人写 'admin.local' => 'admin' 却忘了在系统 hosts 文件里加映射，结果浏览器访问时根本发不出请求，Chrome 直接报 ERR_NAME_NOT_RESOLVED，不是框架问题，是网络层就断了。
- 本地测试务必在
C:\Windows\System32\drivers\etc\hosts（Windows）或/etc/hosts（macOS/Linux）中添加：127.0.0.1 admin.tp81.com index.tp81.com -
domain_bind数组的 key 必须和浏览器地址栏显示的 Host 完全一致（区分大小写、不含端口、不含协议），例如访问https://admin.tp81.com:8080时，$_SERVER['HTTP_HOST']是admin.tp81.com:8080，但domain_bind里只能写admin.tp81.com，否则匹配失败 - 生产环境上线前，检查 DNS A 记录是否生效，用
dig admin.tp81.com +short验证，别等用户反馈“打不开”才查
真正卡住人的往往不是代码写错，而是 runtime/ 目录权限不对、.env 改了没清缓存、或者 Nginx reload 之后忘了重启 php-fpm ——这些细节不验证，再多的配置都是纸面功夫。
