故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT工作流表单API与服务器测试无法回显问题

用户在FastGPT工作流编排中引入表单组件,自测环节表单内容可正常提示;但通过API调用或服务器端测试时,表单内容无法正常回显,未出现预期的提示内容。 当前未查询到官方明确的根因说明,结合场景推测可能与工作流表单参数的API传递逻辑、自测与API/服务器环境的参数绑定差异有关,具体根因需按实际部署环境确认。

现象

用户在FastGPT工作流编排中引入表单组件,自测环节表单内容可正常提示;但通过API调用或服务器端测试时,表单内容无法正常回显,未出现预期的提示内容。

可能原因

当前未查询到官方明确的根因说明,结合场景推测可能与工作流表单参数的API传递逻辑、自测与API/服务器环境的参数绑定差异有关,具体根因需按实际部署环境确认。

排查步骤

  1. 核对工作流中表单的配置参数,确认表单字段名称、绑定变量与工作流内部调用的变量名完全一致。
  2. 对比自测与API/服务器测试的调用参数,检查API请求中是否携带了表单对应的有效输入参数值。
  3. 查看服务器端的运行日志,确认是否存在与表单参数解析相关的错误提示。
  4. 确认当前使用的FastGPT版本,排查是否存在已知的表单回显相关问题(需按实际版本确认)。

解决与验证

  1. 若存在参数名不匹配的情况,修正工作流中表单变量与调用参数的绑定关系,确保名称完全一致。
  2. 完善API请求的参数内容,确保携带了表单所需的全部有效输入值。
  3. 若服务器日志存在参数解析错误,可参考官方文档的表单配置规范调整参数格式(需按实际环境确认)。
  4. 完成调整后,分别通过自测、API调用、服务器测试三种方式验证表单内容是否正常回显。

来源:FastGPT GitHub issue