PHP与n8n自动化工具结合构建AI工作流【说明】-php教程-PHP中文网

n8n Webhook 调用失败主因是路径未显式配置、Content-Type 不匹配、Response Mode 未设为 On Last Node 或凭据传递不安全；需严格匹配 path、用 JSON 发送、启用响应模式、通过凭据管理 API Key。

php与n8n自动化工具结合构建ai工作流【说明】

PHP 调用 n8n webhook 时返回 404 或空响应

n8n 默认只暴露 /webhook 和 /webhook-test 两个公开端点，其他路径（比如 /webhook/ai-process）必须在 n8n 的 Webhook 节点中显式配置 path 字段，否则直接 404。PHP 侧用 file_get_contents() 或 cURL 请求时，如果没核对 n8n 中 Webhook 节点的 exact path（含前导斜杠），就会失败。

实操建议：

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 侧统一用 JSON 发送：json_encode(['text' => 'hello', 'model' => 'gpt-4'])，并设置 header Content-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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

实操建议：

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 不传 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，只走内网或带鉴权的反向代理