Webman原生即多应用架构，无需开启模式；admin.example.com仍进app应用的主因是Host头未透传、check回调域名不匹配、中间件强制调用App::setApp()、全局路由劫持或applications配置缺失。
Webman 本身没有“适配多应用模式”这回事——它原生就是多应用架构，只要目录和配置对得上，域名绑定就水到渠成。关键不是“怎么开启”，而是“怎么不让它走错路”。
为什么 admin.example.com 还是进了 app 应用？
这是最常遇到的表象问题，本质是请求没被正确路由到目标应用上下文。
-
webman/domain插件已启用但没生效，大概率是 Nginx 没透传Host头：检查配置里有没有proxy_set_header Host $host;，Docker 场景还要确认容器网络是否允许 Host 头穿透 - 插件的
check回调里加个日志，打印出$domain值——常见坑是拿到admin.example.com:8080（带端口）或大写域名，而配置里写的是admin.example.com - 其他中间件提前调用了
App::setApp('app')或类似强制切换，直接覆盖了插件设置；全局middleware.php里查一遍有没有这种硬编码 -
config/route.php中存在未加前缀的Route::get('/', ...)，会劫持所有根路径请求，导致域名解析还没走到插件就被截胡
applications 配置不写全，多应用就等于没配
很多人建好了 app/admin 目录，却漏掉 config/app.php 里的 applications 数组，结果框架压根不认这个应用。
- 必须显式声明：
'admin' => ['controller_namespace' => 'app\admin\controller']，键名admin要和目录名、URL 前缀、命名空间前缀三者完全一致（大小写敏感） - 如果目录是
app/Admin，那配置就得写'Admin'，否则 Linux 下 404；别指望框架自动转驼峰或小写 - 命名空间声明必须和配置值严格匹配：文件
app/admin/controller/IndexController.php里得是namespace appdmincontroller;，少一个反斜杠或大小写错都会报Class not found
route.php 自动加载导致路由被覆盖怎么办？
用 glob("app/**/route.php") 一把梭，看着省事，实际非常危险——FastRoute 不合并同路径路由，后加载的会直接干掉前面的。
立即学习“PHP免费学习笔记（深入）”；
- 改用配置驱动加载：在
config/route.php里遍历config('app.applications')，按顺序require对应app/$app/route.php - 每个应用的
route.php必须用Route::group('/admin', function () { ... })包裹，禁止出现Route::get('/user', ...)这类无前缀路由 - 别在任何应用的
route.php里写Route::any('/', ...)，那是给全局 fallback 留的，一写就全局接管
静态资源和 public_path 不随应用切换
这是容易被忽略的隐性限制：Webman 的 public/ 是共享的，app/admin/view 里的 CSS/JS 引用仍走统一 /static/xxx，不会自动加 /admin/ 前缀。
- 前端构建时需明确输出路径，比如 Vite 配置
base: '/admin/'，避免资源 404 - 不要在
app/admin/config/app.php里改public_path，框架不支持 per-app 静态目录隔离 - 如果真要区分资源域，只能靠 Nginx 配置多个
location /admin/static指向不同物理路径，或用 CDN 分发
