iOS App中URL编码异常导致URL为nil崩溃问题求助

你遇到的崩溃本质是URL构造失败后强制解包可选值导致的。具体来说，method里的JSON参数（包含双引号"、大括号{}这些特殊字符）在替换%d后，直接进入prepareURL做编码，但手动拼接+编码的方式没有正确处理URL的结构规范，最终URL(string:)返回了nil，而你用!强制解包就触发了Unexpectedly found nil的致命错误。

手动拼接URL很容易踩编码的坑，苹果提供的URLComponents会自动处理所有URL编码规则，完全避免这类问题，代码也更清晰：

let kBaseURL = "https://www.sampledomain.com/"
let accountID = 20

// 1. 先验证基础URL的有效性
guard let baseURL = URL(string: kBaseURL) else {
    fatalError("基础URL格式无效，请检查kBaseURL的值")
}

// 2. 拼接API路径
let apiPath = "api/MasterData/GetCompanyList"
guard let baseAPIURL = URL(string: apiPath, relativeTo: baseURL) else {
    fatalError("API路径拼接失败")
}

// 3. 用URLComponents处理查询参数
var components = URLComponents(url: baseAPIURL, resolvingAgainstBaseURL: true)!

// 4. 构造并序列化JSON参数
let jsonParams = ["AccountID": accountID]
do {
    let jsonData = try JSONSerialization.data(withJSONObject: jsonParams)
    guard let jsonString = String(data: jsonData, encoding: .utf8) else {
        fatalError("JSON字符串转换失败")
    }
    // 添加查询参数，系统会自动对jsonString做URL编码
    components.queryItems = [URLQueryItem(name: "jsonArgs", value: jsonString)]
} catch {
    fatalError("JSON序列化失败：\(error.localizedDescription)")
}

// 5. 生成最终的URLRequest（这里依然做可选绑定，避免意外）
guard let finalURL = components.url else {
    fatalError("最终URL构造失败")
}
var apiRequest = URLRequest(url: finalURL)

这个方案的优势：

• 自动编码：URLQueryItem会自动把JSON里的特殊字符（比如双引号）转换成URL安全的编码（%22）
• 结构清晰：把URL的基础路径、查询参数拆分处理，后期修改API或者参数更方便
• 安全可靠：每一步都做了可选绑定，避免不小心的强制解包崩溃

如果不想重构代码，也可以调整编码的时机，确保JSON参数在拼接前就被正确编码：

let kBaseURL = "https://www.sampledomain.com/"

private func prepareCompanyListURL(accountID: Int) -> String? {
    // 先构造并编码JSON参数
    let jsonArgs = ["AccountID": accountID]
    guard let jsonData = try? JSONSerialization.data(withJSONObject: jsonArgs),
          let jsonString = String(data: jsonData, encoding: .utf8),
          // 单独对JSON字符串做URL编码
          let encodedJson = jsonString.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
        return nil
    }
    // 拼接编码后的参数到API路径
    let apiPath = "api/MasterData/GetCompanyList?jsonArgs=\(encodedJson)"
    return (kBaseURL + apiPath).addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
}

// 使用时的代码
let accountID = 20
guard let apiURLString = prepareCompanyListURL(accountID: accountID),
      let apiURL = URL(string: apiURLString) else {
    fatalError("URL构造失败，请检查参数或基础URL")
}
var apiRequest = URLRequest(url: apiURL)

• 永远不要强制解包URL(string:)：只要字符串不符合URL规范，这个方法就会返回nil，强制解包必然触发崩溃，一定要用guard或者if let做可选绑定
• 避免手动拼接查询参数：尤其是包含JSON、中文、空格这类特殊内容时，手动编码很容易遗漏规则，优先用URLComponents

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