Swift中带OR查询参数的API调用崩溃问题咨询

直接崩溃原因 #

你代码中NSURL(string: "...")!的强制解包写法，是触发本次崩溃的核心：当传入的字符串无法被系统识别为合法URL时，NSURL/URL的初始化会返回nil，此时强行用!解包空值，就会触发日志中提示的Unexpectedly found nil while unwrapping an Optional value崩溃。
Postman运行正常是因为它会自动补全所有特殊字符的URL编码、修正字符串格式，不会因为拼接不规范就拒绝生成请求；但手写硬编码URL字符串时，只要存在字符编码不规范、格式不符合URL规范的问题，URL初始化就会直接返回nil，触发崩溃。

正确的OR逻辑参数实现方式 #

不要直接把查询参数硬拼在URL字符串里，改用系统原生的URLComponents构造URL，让系统自动完成参数拼接、特殊字符编码全流程，彻底规避手写字符串的格式问题：

1. 拆出接口的基础路径，不把查询参数混在基础路径里硬写
2. 用URLQueryItem定义所有查询参数，按照接口要求的OR逻辑填写参数值
3. 用安全解包的方式取出最终构造完成的URL，杜绝强制解包

示例代码：

// 构造基础URL组件
var urlComponents = URLComponents(string: "https://sportspage-feeds.p.rapidapi.com/games")
// 按接口的OR逻辑规则传入参数，系统自动完成编码
urlComponents?.queryItems = [
    URLQueryItem(name: "status", value: "in progress||final")
]
// 安全校验URL构造结果，避免强制解包
guard let validURL = urlComponents?.url else {
    // 此处处理URL构造失败的分支逻辑，如日志打印、错误提示
    return
}
// 初始化请求
let request = NSMutableURLRequest(url: validURL,
                                  cachePolicy: .useProtocolCachePolicy,
                                  timeoutInterval: 10.0)

常见注意事项 #

• 不要对动态拼接的URL结果直接用!强制解包，哪怕字符串看起来完全符合格式规范，只要涉及参数拼接，都用guard let/if let做安全校验，从根源消除这类崩溃
• 不要手动处理空格、特殊符号的URL编码工作，URLComponents生成的编码结果和服务端要求的格式完全兼容，不会出现Postman可正常运行、原生网络请求因编码差异失败的问题
• 部分接口支持重复传同名查询参数实现OR逻辑（即status=in progress&status=final的格式），这种情况只要在queryItems数组中添加两个同名的参数项即可，不需要手动拼接字符串

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