Alamofire字符串参数异常：硬编码可用，动态传参转Unicode

这问题我之前踩过一模一样的坑！核心原因其实是字符串里的引号编码差异，以及Alamofire处理动态参数的逻辑导致的，咱们一步步说清楚：

为什么动态传参和硬编码不一样？ #

你硬编码的"o'sheas"里的单引号是ASCII标准单引号（Unicode编码U+0027），而你动态传入的passedInString里的单引号，大概率是智能弯引号（Unicode编码U+2019）——这俩看起来肉眼几乎没区别，但编码完全不同！

• Alamofire对ASCII范围内的字符会做标准URL转义（或者直接保留，取决于编码配置），但对非ASCII的Unicode字符（比如弯引号），会转成\U2019这种Unicode转义序列。
• 后端接口应该只识别ASCII的单引号，所以当请求里传的是O\U2019sheas时，自然匹配不到正确结果。
• 硬编码没问题，是因为你直接写的字符串用的是ASCII单引号，系统不会自动替换成弯引号；但用户输入、复制粘贴或者从某些文本源获取的字符串，很容易被系统自动转换成智能弯引号（比如iOS的键盘会自动替换）。

解决方法 #

1. 先把智能引号转成ASCII标准引号 #

写一个字符串扩展，统一替换所有的智能单/双引号：

extension String {
    func normalizeQuotesToASCII() -> String {
        // 智能单引号（弯引号）
        let smartSingleQuote = "\u{2019}"
        // 智能双引号
        let smartDoubleQuote = "\u{201D}"
        // ASCII标准引号
        let asciiSingleQuote = "'"
        let asciiDoubleQuote = "\""
        
        return self.replacingOccurrences(of: smartSingleQuote, with: asciiSingleQuote)
                   .replacingOccurrences(of: smartDoubleQuote, with: asciiDoubleQuote)
    }
}

传参的时候调用这个方法：

PARAMETERS["searchTxt"] = passedInString.normalizeQuotesToASCII()

2. 确保Alamofire用正确的URL编码配置 #

显式指定URLEncoding的参数，避免默认配置的差异：

// 配置编码方式：根据请求方法决定参数位置，布尔值用字面量编码
let urlEncoding = URLEncoding(destination: .methodDependent, boolEncoding: .literal)

AF.request(yourApiUrl, 
           method: .get, 
           parameters: PARAMETERS, 
           encoding: urlEncoding)
    .responseJSON { response in
        // 处理你的响应逻辑
    }

3. 验证传入字符串的真实编码（排查用） #

如果不确定是不是引号的问题，可以打印字符串的Unicode标量确认：

for scalar in passedInString.unicodeScalars {
    print("字符: \(scalar) | Unicode编码: \(scalar.value)")
}

如果输出里出现U+2019，就说明是智能弯引号，替换成U+0027就解决了。

额外提示 #

如果你的场景里还有其他非ASCII特殊字符需要处理，可以用系统自带的URL编码方法：

PARAMETERS["searchTxt"] = passedInString.normalizeQuotesToASCII()
    .addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)

不过核心问题还是智能引号和ASCII引号的差异，这是最容易被忽略的点！

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