n8n Webhook 调用失败主因是路径未显式配置、Content-Type 不匹配、Response Mode 未设为 On Last Node 或凭据传递不安全；需严格匹配 path、用 JSON 发送、启用响应模式、通过凭据管理 API Key。
PHP 调用 n8n webhook 时返回 404 或空响应
n8n 默认只暴露 /webhook 和 /webhook-test 两个公开端点，其他路径（比如 /webhook/ai-process）必须在 n8n 的 Webhook 节点中显式配置 path 字段，否则直接 404。PHP 侧用 file_get_contents() 或 cURL 请求时，如果没核对 n8n 中 Webhook 节点的 exact path（含前导斜杠），就会失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- n8n 工作流里 Webhook 节点的
Path填/ai/process，PHP 就必须请求https://your-n8n.com/webhook/ai/process，不能少斜杠、不能多斜杠、不能大小写混用 - 确保 n8n 已启用 webhook：启动时加
--tunnel（开发）或反向代理已透传POST /webhook*（生产） - PHP 发送 JSON 数据时，必须设
Content-Type: application/json，否则 n8n 不解析body，$input.body为空 - 测试阶段先用
curl -X POST https://n8n.local/webhook/test -H "Content-Type: application/json" -d '{"msg":"ok"}'确认通路
PHP 传参后 n8n 拿不到 $input.body 字段
n8n 的 Webhook 节点默认只接收 raw body，但 PHP 若用 http_build_query() 发送 application/x-www-form-urlencoded，n8n 不会自动解包——它只会把整串当字符串塞进 $input.body，不会转成对象。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- PHP 侧统一用 JSON 发送：
json_encode(['text' => 'hello', 'model' => 'gpt-4'])，并设置 headerContent-Type: application/json - n8n 侧无需额外解析，
$input.body.text可直接取值 - 若必须传 form-data（如含文件），改用 n8n 的
HTTP Request节点反向调用 PHP 接口，避开 Webhook 的 body 解析限制 - 检查 n8n 日志：Webhook 触发后，点执行记录里的「Input Data」看原始 body 是否符合预期
AI 响应结果从 n8n 回传 PHP 失败或超时
n8n 的 Webhook 默认是「fire-and-forget」模式：收到请求就立即返回 200，后续节点异步执行。如果你在 PHP 里等着 AI 结果（比如调用大模型后返回摘要），必须开启 Webhook 节点的 Response Mode: "On Last Node"，且最后一个节点必须是 Respond to Webhook。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Webhook 节点属性里勾选
Response Mode → On Last Node - 工作流末尾必须接
Respond to Webhook节点，并在它的Response Body中填{{$json}}或具体字段如{{ $input.body.result }} - PHP 的 cURL 需设超时：至少
timeout=60（OpenAI 类 API 常需 10–30 秒），避免 n8n 还在跑，PHP 就断连了 - 别依赖 n8n 的「Test」按钮测回传——它不走真实 webhook 流程，要用外部 PHP 脚本实测
PHP 与 n8n 之间敏感参数（如 API Key）如何安全传递
n8n 支持凭据（Credentials）管理，但 PHP 无法直接读取 n8n 的凭据。常见错误是把 API Key 写死在 Webhook URL 里（?key=xxx），或明文塞进 body，既不合规也不安全。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- PHP 不传 key，只传业务数据；n8n 侧用
HTTP Request节点调用 AI 服务时，绑定预设的API Key凭据（如 OpenAI Credential） - 若 PHP 必须动态指定模型或 endpoint，用 n8n 的环境变量 +
$env.NODE_ENV控制，而非传敏感值 - Webhook URL 加 Basic Auth：n8n 启动时设
N8N_BASIC_AUTH_USER和N8N_BASIC_AUTH_PASSWORD，PHP cURL 用User:Pass@格式或Authorization: Basic xxx - 生产环境务必关掉 n8n 的
WEBHOOK_TUNNEL_URL，禁用 public tunnel，只走内网或带鉴权的反向代理
