ThinkPHP5 伪静态与 GraphQL 路由可共存，但必须隔离 GraphQL 入口：Apache 下在 .htaccess 中前置排除 /graphql；Nginx 下需单独配置 location = /graphql 指向独立 PHP 入口；GraphQL 必须绕过 TP5 路由和中间件，推荐使用 public/graphql.php 直接启动。
ThinkPHP5 伪静态和 GraphQL 路由能共存，但必须让 GraphQL 请求绕过常规路由解析，否则会被当成普通控制器路径拦截或 404。
GraphQL 请求为什么会被伪静态规则吞掉
TP5 默认伪静态规则（如 RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]）会把所有非真实文件/目录的请求都转发给 index.php，然后由框架根据 PATH_INFO 解析成 控制器/方法。而 GraphQL 接口通常走 /graphql 这类固定路径，它不是控制器，也不该被路由层当控制器处理——否则要么报“控制器不存在”，要么进错中间件链。
- 常见现象：访问
/graphql返回 TP5 的 404 页面，或直接跳转到默认首页 - 根本原因：服务器把
/graphql当成一个“不存在的控制器路径”，交给了 TP5 路由系统，而你没在route/route.php里显式注册它 - 关键点：GraphQL 不是靠控制器实现的，它应该由一个独立入口或中间件接管，不能依赖 URL 路由自动匹配
Apache 下如何放行 /graphql 路径
在 public/.htaccess 中，把 RewriteCond 判断提前加上对 /graphql 的排除，确保它不进 index.php 的 PATH_INFO 流程。
- 在两个
RewriteCond之前加一行：RewriteCond %{REQUEST_URI} !^/graphql - 完整片段示例（放在
public/.htaccess）：
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_URI} !^/graphql
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</IfModule>
- 注意顺序：
RewriteCond %{REQUEST_URI} !^/graphql必须在其他条件之前，否则会被后两个条件先拦截掉 - 不要写成
!^/graphql/或!^/graphql.*，!^/graphql已覆盖/graphql和/graphql?等变体
Nginx 下怎么避免 /graphql 被 try_files 吞掉
Nginx 的 try_files 是顺序匹配，只要 /graphql 不是真实文件，就会落到 /index.php；但你要的是它直接进 GraphQL 处理逻辑，而不是被 TP5 路由兜底。
立即学习“PHP免费学习笔记（深入）”；
- 最稳妥做法：单独配一个
location = /graphql块，把它指向 PHP 处理流程，跳过 TP5 路由 - 示例（加在
server块内，且必须在location /之前）：
location = /graphql {
try_files @graphql;
}
location @graphql {
fastcgi_pass php-fpm;
fastcgi_param SCRIPT_FILENAME $document_root/graphql.php;
fastcgi_param PATH_INFO "";
include fastcgi_params;
}
- 或者更轻量：复用
index.php，但传入特殊参数绕过路由，例如在public/index.php开头加判断： if ($_SERVER['REQUEST_URI'] === '/graphql') { require __DIR__ . '/graphql_entry.php'; exit; }- 这样既不用改 Nginx，又确保 GraphQL 不经过
think\App::run()的完整路由链
GraphQL 入口文件必须避开 TP5 路由中间件
即使请求进了 index.php，只要没走 think\App::run()，就不会触发 ParseUrl、CheckRequestCache 等中间件——这对 GraphQL 是必须的，否则 CSRF 验证、跨域头、输入过滤可能误伤。
- 推荐把 GraphQL 入口放在
public/graphql.php，内容极简：
<?php // public/graphql.php require __DIR__ . '/../vendor/autoload.php'; require __DIR__ . '/../app/common/GraphQLSchema.php'; use GraphQL\Server\StandardServer; use GraphQL\Server\ServerConfig; $config = new ServerConfig(); $config->setSchema(\app\common\GraphQLSchema::getInstance()); $server = new StandardServer($config); $server->serve();
- 然后 Apache/Nginx 都直接指向这个文件，不经过 TP5 框架启动流程
- 别把 GraphQL 放在
app/controller下——TP5 会强制走控制器生命周期，没法控制执行时机
真正容易被忽略的是：GraphQL 接口一旦被 TP5 路由系统捕获，就再也无法干净退出；哪怕你在中间件里 return json(...)，后续仍可能被模板渲染或日志中间件干扰。所以“隔离入口”不是优化项，是必要动作。
