如何用Objective-C（AFNetworking）构造POST请求的多维键值数组参数

我之前在做Objective-C项目用AFNetworking发嵌套参数的POST请求时，也碰到过服务器解析格式不对的问题，刚好能给你几个实用的解决方案，先得明确服务器期望的参数格式是JSON还是表单编码，这是关键：

情况1：服务器期望JSON格式的请求体 #

如果后端接口接收的是JSON格式的请求体，那处理起来最简单，直接用AFNetworking的JSON序列化器就行，正常构造嵌套的NSDictionary和NSArray就好：

// 构造嵌套的地址数组（多维数组：数组里包含键值对字典）
NSDictionary *addressItem1 = @{@"street": @"Main Street", @"city": @"New York", @"zip": @"10001"};
NSDictionary *addressItem2 = @{@"street": @"Second Avenue", @"city": @"London", @"zip": @"SW1A 1AA"};
NSArray *addressArray = @[addressItem1, addressItem2];

// 组装最终参数
NSDictionary *parameters = @{@"data": @{@"address": addressArray}};

// 初始化AFHTTPSessionManager并设置JSON请求序列化器
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
manager.requestSerializer = [AFJSONRequestSerializer serializer];
// 显式设置Content-Type为application/json（有些场景下需要）
[manager.requestSerializer setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

// 发送POST请求
[manager POST:@"你的接口地址" parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
    NSLog(@"请求成功，返回数据：%@", responseObject);
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
    NSLog(@"请求失败：%@", error.localizedDescription);
}];

这种方式下，服务器收到的请求体是标准JSON，data.address就是一个包含多个键值对对象的数组，完全符合多维数组的要求。

情况2：服务器期望x-www-form-urlencoded格式的嵌套参数 #

如果后端要求的是表单编码格式（比如参数类似data[address][0][street]=Main%20Street这种），AFNetworking默认的表单序列化器对嵌套数组的处理可能不符合服务器预期，这时候有两种处理方式：

方法A：手动构造扁平化参数（适合结构简单的场景） #

直接把嵌套结构展开成带索引的键名，手动组装参数字典：

NSMutableDictionary *parameters = [NSMutableDictionary dictionary];

// 第一个地址项
[parameters setObject:@"Main Street" forKey:@"data[address][0][street]"];
[parameters setObject:@"New York" forKey:@"data[address][0][city]"];
[parameters setObject:@"10001" forKey:@"data[address][0][zip]"];

// 第二个地址项
[parameters setObject:@"Second Avenue" forKey:@"data[address][1][street]"];
[parameters setObject:@"London" forKey:@"data[address][1][city]"];
[parameters setObject:@"SW1A 1AA" forKey:@"data[address][1][zip]"];

// 使用默认的表单序列化器发送请求
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
[manager POST:@"你的接口地址" parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
    NSLog(@"请求成功");
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
    NSLog(@"请求失败：%@", error);
}];

这种方式直接把每个嵌套字段对应到服务器期望的键名，能确保参数格式完全符合要求。

方法B：自定义参数序列化器（适合复杂嵌套结构） #

如果你的参数嵌套层级多、结构复杂，手动构造太麻烦，可以自定义一个表单序列化器，重写参数序列化逻辑，自动生成带索引的键名：

// 自定义表单请求序列化器
@interface CustomFormRequestSerializer : AFHTTPRequestSerializer
@end

@implementation CustomFormRequestSerializer

- (NSURLRequest *)requestBySerializingRequest:(NSURLRequest *)request withParameters:(id)parameters error:(NSError *__autoreleasing *)error {
    if (!parameters || ![parameters isKindOfClass:[NSDictionary class]]) {
        return [super requestBySerializingRequest:request withParameters:parameters error:error];
    }
    
    // 手动生成符合要求的表单查询字符串
    NSString *queryString = [self generateQueryStringFromParameters:(NSDictionary *)parameters];
    NSMutableURLRequest *mutableRequest = [request mutableCopy];
    
    // 设置POST请求的HTTP Body
    if ([[mutableRequest HTTPMethod] isEqualToString:@"POST"]) {
        [mutableRequest setHTTPBody:[queryString dataUsingEncoding:NSUTF8StringEncoding]];
        [mutableRequest setValue:@"application/x-www-form-urlencoded; charset=utf-8" forHTTPHeaderField:@"Content-Type"];
    }
    
    return mutableRequest;
}

- (NSString *)generateQueryStringFromParameters:(NSDictionary *)parameters {
    NSMutableArray *queryComponents = [NSMutableArray array];
    
    [parameters enumerateKeysAndObjectsUsingBlock:^(id key, id value, BOOL *stop) {
        NSString *encodedKey = [self urlEncodedString:key];
        [self appendComponentForKey:encodedKey value:value toArray:queryComponents];
    }];
    
    return [queryComponents componentsJoinedByString:@"&"];
}

- (void)appendComponentForKey:(NSString *)key value:(id)value toArray:(NSMutableArray *)array {
    if ([value isKindOfClass:[NSDictionary class]]) {
        // 处理嵌套字典
        NSDictionary *dictValue = (NSDictionary *)value;
        [dictValue enumerateKeysAndObjectsUsingBlock:^(id subKey, id subValue, BOOL *stop) {
            NSString *newKey = [NSString stringWithFormat:@"%@[%@]", key, subKey];
            [self appendComponentForKey:newKey value:subValue toArray:array];
        }];
    } else if ([value isKindOfClass:[NSArray class]]) {
        // 处理数组，生成带索引的键名
        NSArray *arrayValue = (NSArray *)value;
        [arrayValue enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
            NSString *newKey = [NSString stringWithFormat:@"%@[%lu]", key, (unsigned long)idx];
            [self appendComponentForKey:newKey value:obj toArray:array];
        }];
    } else {
        // 处理普通值
        NSString *encodedValue = [self urlEncodedString:value];
        NSString *component = [NSString stringWithFormat:@"%@=%@", key, encodedValue];
        [array addObject:component];
    }
}

- (NSString *)urlEncodedString:(id)object {
    NSString *string = [object description];
    return [string stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
}

@end

然后使用这个自定义序列化器发送请求：

// 构造嵌套参数
NSDictionary *addressItem1 = @{@"street": @"Main Street", @"city": @"New York", @"zip": @"10001"};
NSDictionary *addressItem2 = @{@"street": @"Second Avenue", @"city": @"London", @"zip": @"SW1A 1AA"};
NSArray *addressArray = @[addressItem1, addressItem2];
NSDictionary *parameters = @{@"data": @{@"address": addressArray}};

// 使用自定义序列化器
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
manager.requestSerializer = [[CustomFormRequestSerializer alloc] init];

[manager POST:@"你的接口地址" parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
    NSLog(@"请求成功");
} failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
    NSLog(@"请求失败：%@", error);
}];

这个序列化器会自动把嵌套的字典和数组转换成服务器期望的data[address][0][street]这种格式，适合复杂参数结构的场景。

最后建议你先和后端同事确认接口期望的参数格式（JSON还是表单编码），再选择对应的方案，这样能少走弯路~

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