iOS中URL的中文编码和URL拼接字符串的问题

一、URL中的中文编码问题

在开发中，后端提供的接口中，有个图片的url中带有了中文，导致在创建NSURL时返回为nil。类似下面的代码，如果你的SDWebImage下载图片提示错误Trying to load a nil url，可能就是因为中文编码问题造成的。

NSString *urlString = @"http://www.baidu.com/image?name=微信_123.jpg";
// 此时url为nil
NSURL *url = [NSURL URLWithString:urlString];

出现这种情况可以使用[NSString stringByAddingPercentEscapesUsingEncoding:]方法先将urlString转码为UTF8。

NSString *urlString = @"http://www.baidu.com/image?name=微信_123.jpg";
// url.absoluteString == "http://www.baidu.com/image?name=%E5%BE%AE%E4%BF%A1_123.jpg"
NSURL *url = [NSURL URLWithString:[urlString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];

但是在我开发的工程里，并不是所以url都没有转码，已经转码的url调用上面的方法会造成二次转码。

NSString *urlString = @"http://www.baidu.com/image?name=%E5%BE%AE%E4%BF%A1_123.jpg";
// url.absoluteString == "http://www.baidu.com/image?name=%25E5%25BE%25AE%25E4%25BF%25A1_123.jpg"
NSURL *url = [NSURL URLWithString:[urlString stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];

此时我们就需要使用下面的方法。

正确的使用方式

// 该方法可以根据urlString中的内容判断是否转码，没有转码才进行转码
static NSString * EncodeString(NSString * uncodeString) {
    return (NSString *) CFBridgingRelease(CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, (CFStringRef) uncodeString, (CFStringRef)@"!$&'()*+,-./:;=?@_~%#[]",NULL,kCFStringEncodingUTF8));
}

NSString *urlString = @"http://www.baidu.com/image?name=微信_123.jpg";
NSString *urlString1 = @"http://www.baidu.com/image?name=%E5%BE%AE%E4%BF%A1_123.jpg";

// url.absoluteString == url1.absoluteString == "http://www.baidu.com/image?name=%25E5%25BE%25AE%25E4%25BF%25A1_123.jpg"
NSURL *url = EncodeString(urlString);
NSURL *url1 = EncodeString(urlString1);

CFURLCreateStringByAddingPercentEscapes("参数1","参数2","参数3","参数4","参数5");
//方法说明
//首先返回一个CFStringRef
//参数3 不转义字符 参数4 指定转义字符
具体参数解释 :
第一个参数是AllocatorRef –>内存分配类型(内存分配器下一节说明)
第二个参数是CFStringRef –>待转码字符串
第三个参数是CFStringRef –>不转义字符
第三个参数是CFStringRef –>指定转义字符
第三个参数是CFStringEncoding –>编码类型 KCFStringEncodingUTF8
这种方法有内存泄漏一定要释放:CFRelease(CFStringRef)
PS:CFBridgingRelease(CFStringRef) 释放掉CFStringRef 并且转化为NSString;

二、URL拼接字符串问题

在工程中，因为后端接口返回的image都是大图，所以需要前端在后面拼接参数thumb=1，所以想做一个通用的添加参数的方法。
url通常会有以下几种形式：
1、https://www.baidu.com ----------------------------------------------noquery
2、https://www.baidu.com/act/index.html -------------------------------noquery
3、https://www.baidu.com/act/index.html? ------------------------------noquery but has ?
4、https://www.baidu.com/act/index.html?foo=bar ----------------------has query
5、https://www.baidu.com/act/index.html?foo1=bar1&foo2=bar2 --------has query
6、https://www.baidu.com/act/index.html?foo1=bar1&foo2=bar2#top ---has query and fragment
因为大概有上面几种形式，所以直接用匹配的方式很复杂，不过幸好有系统方法可以帮我们分解url，然后合成url。

+ (NSURL *)url:(NSString *)urlString appendQuery:(NSString *)tmpQuery {
    if (urlString.length == 0 || tmpQuery.length == 0) {
        return nil;
    }
    NSURLComponents *components = [NSURLComponents componentsWithString:urlString];
    NSString *query = components.query;
    query = (query&&![query isEqualToString:@""])? [query stringByAppendingString:[NSString stringWithFormat:@"&%@",tmpQuery]] : tmpQuery;
    // components.query会过度编码,已经编码的字符串会再次转码一次
    // components.query = query;
    // components.percentEncodedQuery不会是参数转码，但是需要保证设置的值不能有非法字符，所以需要保证query必须是转码后的字符串
    components.percentEncodedQuery = EncodeString(uncodeString);
    return components.URL;
}

在iOS9以后CFURLCreateStringByAddingPercentEscapes:失效了

所以可以使用下面的方法替换。

static NSString * EncodeString(NSString * uncodeString) {
    if (uncodeString.length == 0) {
        return nil;
    }
    // 先尝试使用原始字符串创建url
    NSURL *url = [NSURL URLWithString:uncodeString];
    if (url == nil) {// 如果url为nil，说明uncodeString中含有特殊字符串，则调用下面的方法进行转码
        NSString *decodeString = (NSString *)CFBridgingRelease((__bridge CFTypeRef _Nullable)([uncodeString stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]]));
        url = [NSURL URLWithString:decodeString.length >0 ? decodeString : uncodeString];
    }
    return url.absoluteString;
}

参考内容：
iOS-URL编解码
再探URL拼接的坑