AppCode环境下Swift合法URL传入构造器却返回nil的原因

对应开发场景 #

Swift开发新手在AppCode环境运行应用时，传入自认符合规范的URL字符串给构造器初始化，最终得到的实例为nil；已在调试器中添加对应观测项，可结合实际调试状态定位问题。

常见问题原因 #

• 合法性校验规则差异：URL(string:)的校验完全遵循RFC 3986规范，比浏览器的兼容标准严格很多，只要字符串不符合规范就会直接返回nil，常见不合规场景包括：
  • 字符串内存在未做百分号编码的特殊字符：比如中文、空格、emoji、未转义的符号，即便这类字符串在浏览器中可以正常打开，也无法通过初始化校验
  • 缺失URL必要结构：比如没有添加http:///https://协议头、字符串仅为不带域名的相对路径片段（如/api/user/list），都会因结构不完整校验失败
  • 混入不可见异常字符：从配置文件、接口返回、剪贴板获取的URL，可能在前后附带换行符、零宽空格、全角空格等肉眼无法识别的字符，视觉上和正常URL无差异，但实际无法通过校验
• 初始化方法误用：需要基于已有基底URL拼接相对路径时，直接调用URL(string: 相对路径片段)必然返回nil，需要改用支持相对路径的初始化方法：URL(string: 相对路径, relativeTo: 已校验合法的基底URL)
• 自定义编码逻辑错误：如果手动对URL字符串做转义编码，误把必须保留的结构字符（如:、/、?、#）也做了百分号转义，会导致构造器无法识别合法的URL结构，同样会返回nil

快速排查技巧 #

在调试控制台打印待初始化的原始字符串长度、逐字符的编码值，和视觉上看到的URL内容做比对，即可快速定位隐藏字符、结构缺失类问题。

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