ThinkPHP6.0本身不是微服务框架，不内置服务注册、发现或网关能力；其作为下游服务提供者接入第三方网关时，需暴露健康接口、监听非localhost地址、确保网络可达，并按网关要求配置响应头与元数据。
ThinkPHP6.0 本身不是微服务框架，不内置服务注册、发现或网关能力。所谓“配置微服务网关后服务发现失败”，本质是 TP6 作为**下游服务提供者**（即被调用方），在接入 Spring Cloud Gateway、Kong、Nacos 等第三方网关时，因自身暴露方式、健康检查、元数据或网络配置不匹配，导致网关无法正确识别、路由或探活该服务。
确认 TP6 是作为服务提供者接入网关
TP6 没有服务注册中心客户端（如 Nacos SDK、Eureka Client），不能主动向 Nacos/ZooKeeper 注册。若你期望它被网关发现，必须满足两个前提之一：
- 网关采用静态服务发现：手动在网关配置中写死 TP6 服务的 IP + 端口（如
http://192.168.1.100:8000），此时只需确保该地址可被网关网络访问； - 网关支持HTTP 健康检查 + 主动探测（如 Kong 的
healthchecks、Spring Cloud Gateway 的SimpleDiscoveryClient配合 Actuator）：此时需在 TP6 中暴露一个稳定返回 200 的健康端点，并确保路径、响应格式符合网关要求。
暴露标准健康检查接口（关键动作）
多数网关默认对 /actuator/health 或 /health 发起 GET 请求。TP6 可快速添加一个轻量健康路由：
- 在
route/app.php中添加：Route::get('/health', function () { return json(['status' => 'UP', 'timestamp' => time()]); }); - 确保该路由不经过鉴权、Token 校验等中间件（加
->middleware('allow_cross_domain')或单独排除）； - 访问
http://your-tp6-domain/health应直接返回 JSON 且状态码为 200； - 若网关要求特定响应结构（如含
components字段），按其文档微调返回内容。
检查服务地址与网络可达性
网关发现失败，80% 源于基础连通问题：
立即学习“PHP免费学习笔记（深入）”；
-
TP6 必须监听非 127.0.0.1 的地址：启动命令不能是
php think run -H 127.0.0.1:8000，应改为php think run -H 0.0.0.0:8000或指定宿主机真实 IP； -
防火墙/安全组放行端口：确认服务器防火墙（
ufw/firewalld）及云厂商安全组允许网关所在机器访问 TP6 的端口（如 8000）； -
Docker 场景注意网络模式：若 TP6 运行在容器内，网关在宿主机或另一容器，避免使用
bridge模式未映射端口，推荐host模式或显式-p 8000:8000； - 用
telnet tp6-host-ip 8000或curl -v http://tp6-host-ip:8000/health从网关机器直连验证。
适配网关的元数据与请求头要求
部分智能网关（如 Nacos + Spring Cloud Gateway 组合）会读取服务响应头或响应体中的元数据用于路由决策：
- 确保 TP6 响应中包含必要头信息，例如：
header('X-Service-Name', 'api-user');或header('X-Environment', 'prod');（按网关文档要求设置）； - 若网关依赖 Host 头做路由（如多租户场景），TP6 接口需能正确解析并响应
Host，避免因 Nginx 反向代理丢失该头——检查 Nginx 配置是否含proxy_set_header Host $host;； - 网关转发请求时可能携带
X-Forwarded-For、X-Real-IP，TP6 如需记录真实 IP，需在config/app.php中配置'trusted_proxy' => ['127.0.0.1', '网关IP段']。
