NiFi 1.19.1：InvokeHTTP POST无法发送含大写字母的请求头

核心原因 #

NiFi的属性系统默认大小写不敏感，且header.*格式的属性在InvokeHTTP处理时，会被自动标准化为HTTP头的常规格式（部分标准头会被强制处理），导致自定义或带大写的头字段丢失原始大小写。另外，InvokeHTTP对http.headers属性的优先级高于单个header.*属性，直接用前者可以绕过自动处理逻辑。

具体解决步骤 #

• 开启「Use Headers from Attributes」开关
  确认InvokeHTTP处理器的该选项已勾选，这是属性头传递的基础前提。

• 使用http.headers属性直接传递原始头
  放弃逐个配置header.*属性，转而将所有需要转发的请求头组装成键值对格式（每行一个Key: Value），存入http.headers属性中。InvokeHTTP会直接使用这个属性的内容作为请求头，不会修改大小写。
  比如属性值示例：

  Date: Tue, 15 Nov 1994 08:12:31 GMT
  type: application/json
  X-Custom-Header: TestValue
  

• 用ExecuteScript预处理属性（自动提取所有header）
  如果需要自动转发上游传来的所有请求头，可添加ExecuteScript处理器，编写脚本提取FlowFile中所有header.*属性，组装成http.headers：
  示例Groovy脚本：

  def flowFile = session.get()
  if (!flowFile) return
  
  def headerBuilder = new StringBuilder()
  flowFile.attributes.each { attrKey, attrValue ->
      if (attrKey.startsWith('header.')) {
          def rawHeaderName = attrKey.substring(7)
          headerBuilder.append("${rawHeaderName}: ${attrValue}\n")
      }
  }
  
  flowFile = session.putAttribute(flowFile, 'http.headers', headerBuilder.toString().trim())
  session.transfer(flowFile, REL_SUCCESS)
  

  把这个处理器放在InvokeHTTP之前，确保http.headers被正确设置。

• 检查目标负载均衡器的配置
  部分负载均衡器（如Nginx）默认会将请求头名称转换为小写，需要修改配置保留原始大小写：

  • Nginx需添加underscores_in_headers on;（如果头含下划线），同时确保没有强制转小写的第三方模块或配置。
  • 其他LB可查阅官方文档，关闭头名称标准化的配置。

• 验证上游处理器的头提取逻辑
  如果上游用ExtractHttpHeaders等处理器获取请求头，需确认其配置中是否开启了「Preserve Header Case」选项，确保原始大小写的头被正确存入header.*属性中。

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