NiFi中HTTP Post请求头未转化为FlowFile属性问题排查

• 请求头命名不符合HTTP标准
  HTTP规范中请求头字段名不允许使用下划线（_），多数HTTP客户端（包括requests）会自动将下划线转换为连字符（-），或直接忽略带下划线的请求头。你当前使用的filename、file_id包含下划线，大概率会被NiFi ListenHTTP忽略。建议将请求头改为File-Name、Response-Url、File-Id这类连字符格式，并在ListenHTTP的HTTP Headers to Add as Attributes配置项中填写对应名称。

• ListenHTTP属性配置格式错误
  检查HTTP Headers to Add as Attributes的配置：必须每行填写一个请求头名称，不能用逗号或其他分隔符。正确配置示例：

File-Name
Response-Url
File-Id

若配置格式错误，NiFi无法正确解析要提取的请求头。

• Python requests请求头发送方式有误
  确认requests代码中请求头是明确放在headers字典中，而非嵌套在files参数里。正确示例：

import requests

headers = {
    "File-Name": "demo.txt",
    "Response-Url": "http://your-callback-url",
    "File-Id": "f-123456"
}
files = {"file": open("demo.txt", "rb")}

resp = requests.post("http://nifi-server:port/your-endpoint", headers=headers, files=files)

• 属性冲突或未正确查看属性
  若FlowFile本身已存在同名属性，ListenHTTP的Conflict Resolution Strategy若设为Keep Existing，则不会覆盖原有属性。可在后续处理器（如UpdateAttribute或LogAttribute）中查看完整属性列表，确认自定义头是否被添加。

• 端点或请求方法不匹配
  验证请求的URL是否与ListenHTTP配置的HTTP Context Map上下文路径完全一致，同时确认Allowed Methods包含POST方法，避免请求被处理器拒绝或未正确匹配。

内容的提问来源于stack exchange，提问作者Florian H