如何正确计算HTTP POST请求x-www-form-urlencoded格式请求体的Content-Length

你的问题核心在于没有按照x-www-form-urlencoded的规范构造请求体——手动拼接字符串时用了冒号分隔键值、缺少&分隔符，也没对特殊字符做URL编码，这直接导致Content-Length计算错误，同时服务器也无法正确解析请求体。

正确的处理逻辑 #

x-www-form-urlencoded格式的请求体必须遵循以下规则：

1. 单个键值对采用key=value的格式
2. 多个键值对之间用&分隔
3. 键和值中的特殊字符（比如://、空格、特殊符号等）必须做URL编码

手动计算Content-Length的正确代码（以Dart为例） #

从你用到utf8.encode的写法推测是Dart开发，以下是规范的实现：

import 'dart:convert';

// 你的原始请求体Map
Map<String, String> body = { 
  'grant_type': 'authorization_code', 
  'client_id': 'clientid', 
  'code': authCode, 
  'redirect_uri': 'http://localhost:8080/login/callback', 
  'code_verifier': 'codeverifier', 
};

// 1. 对每个键值对做URL编码，拼接成符合规范的请求体字符串
String encodedBody = body.entries.map((entry) {
  return '${Uri.encodeQueryComponent(entry.key)}=${Uri.encodeQueryComponent(entry.value)}';
}).join('&');

// 2. 转换为UTF-8字节数组，得到准确的Content-Length
List<int> bytes = utf8.encode(encodedBody);
int contentLength = bytes.length;

更省心的方案：用HTTP客户端库自动处理 #

其实大多数HTTP客户端库（比如Dart的http或dio包）会自动帮你完成x-www-form-urlencoded的编码和Content-Length的设置，完全不用手动计算，避免出错：

import 'package:http/http.dart' as http;

var response = await http.post(
  Uri.parse('https://your-token-endpoint.com/token'),
  body: body, // 库会自动编码并设置正确的Content-Type和Content-Length
);

为什么之前的方法无效？ #

• 你用了冒号:分隔键和值，不符合key=value的格式规范
• 没有用&分隔多个键值对，导致请求体结构完全错误
• 没有对特殊字符做URL编码（比如redirect_uri里的://），既会导致字节数计算不准确，也会让服务器无法解析请求内容

内容的提问来源于stack exchange，提问作者Ali Yılmaz