ASP.NET MVC中如何为HttpClient设置Int类型的terminalId请求头

HTTP 协议的所有请求头，在网络传输层面天然都是「字符串键、字符串值」的文本结构，不存在原生的整数类型请求头。你感知到的“HttpClient 仅支持<String, String>类型请求头”不是框架的实现限制，是 HTTP 协议本身的规范定义。
对接方要求terminalId为Int类型的真实语义，是要求该头的值必须是可被服务端解析为整数的纯数字字符串，不接受非数字、带特殊格式的无效值，并非要求传输时传递非字符串类型的原始值。

你写的client.DefaultRequestHeaders.Add("terminalId", 123); 本身无法通过编译，因为DefaultRequestHeaders.Add方法的入参要求头值必须是字符串类型，直接传整数参数会触发类型不匹配的编译错误。

• 直接将整数类型的terminalId转为字符串作为头值传入即可，服务端收到字符串后会自行完成整数解析，完全满足对接要求：

  // 替换原来直接传整数的错误写法
  client.DefaultRequestHeaders.Add("terminalId", 123.ToString());
  

• 如果遇到自定义头被HttpClient默认的格式校验逻辑拦截报错，可以使用跳过校验的方法添加，避免不必要的格式拦截：

  client.DefaultRequestHeaders.TryAddWithoutValidation("terminalId", 123.ToString());
  

• 整数转字符串时不要额外加引号、空格、非数字字符，保持纯数字格式，否则服务端做整数类型转换时会触发解析失败
• 无需为了“模拟Int类型”在传值时附加额外类型标记，传输过程中所有头内容都是纯文本，服务端只校验值的可解析性

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