iOS：我如何接收 HTTP 401 而不是 -1012 NSURLErrorUserCancelledAuthentication

IOS

在IOS应用开发中，我们经常会遇到处理HTTP请求的情况。其中，有一种常见的情况是当我们向服务器发送请求时，可能会收到HTTP 401错误，表示未经授权的访问。然而，在某些情况下，我们可能希望能够捕获这个错误，并以不同的方式处理，而不是简单地使用默认的错误代码-1012 NSURLErrorUserCancelledAuthentication。本文将介绍如何在IOS应用中接收HTTP 401错误，并提供案例代码进行演示。

1. 设置NSURLSessionDelegate

要捕获HTTP 401错误，我们首先需要设置NSURLSessionDelegate，并实现其代理方法。NSURLSessionDelegate是一个协议，用于处理NSURLSession的各种事件和错误。我们可以通过实现其中的-URLSession:didReceiveChallenge:completionHandler:方法来处理HTTP 401错误。

Swift
class MySessionDelegate: NSObject, URLSessionDelegate {
    func URLSession(session: NSURLSession, didReceiveChallenge challenge: NSURLAuthenticationChallenge, completionHandler: (NSURLSessionAuthChallengeDisposition, NSURLCredential?) -> Void) {
        if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust {
            // 处理服务器信任的逻辑
        } else if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodHTTPBasic {
            // 处理基本认证的逻辑
        } else if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodHTTPDigest {
            // 处理摘要认证的逻辑
        } else {
            // 其他认证方法的处理
        }
    }
}

在上面的代码中，我们创建了一个名为MySessionDelegate的类，并实现了URLSession:didReceiveChallenge:completionHandler:方法。在该方法中，我们可以根据protectionSpace.authenticationMethod的值来判断当前的认证方式，然后执行相应的逻辑。

2. 处理HTTP 401错误

当我们收到HTTP 401错误时，我们可以通过调用completionHandler来处理该错误。在completionHandler中，我们需要传递一个NSURLSessionAuthChallengeDisposition枚举值，指示我们希望如何处理该错误。以下是一些常见的处理方式：

- NSURLSessionAuthChallengeUseCredential：使用提供的凭据进行认证。

- NSURLSessionAuthChallengePerformDefaultHandling：执行默认的认证处理方式。

- NSURLSessionAuthChallengeCancelAuthenticationChallenge：取消认证，放弃当前请求。

Swift
class MySessionDelegate: NSObject, URLSessionDelegate {
    func URLSession(session: NSURLSession, didReceiveChallenge challenge: NSURLAuthenticationChallenge, completionHandler: (NSURLSessionAuthChallengeDisposition, NSURLCredential?) -> Void) {
        if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodHTTPBasic {
            let credential = NSURLCredential(user: "username", password: "password", persistence: .ForSession)
            completionHandler(.UseCredential, credential)
        } else {
            completionHandler(.PerformDefaultHandling, nil)
        }
    }
}

在上面的代码中，我们针对HTTP基本认证方式进行了处理。如果收到HTTP 401错误，并且认证方式是基本认证，我们可以通过创建一个NSURLCredential对象，并调用completionHandler来使用提供的凭据进行认证。

3. 使用自定义的NSURLSessionDelegate

一旦我们实现了自定义的NSURLSessionDelegate，我们就可以在创建NSURLSession时将其设置为delegate，从而在发生HTTP 401错误时能够捕获并处理。

Swift
let sessionConfig = NSURLSessionConfiguration.defaultSessionConfiguration()
let delegate = MySessionDelegate()
let session = NSURLSession(configuration: sessionConfig, delegate: delegate, delegateQueue: nil)

在上面的代码中，我们创建了一个NSURLSessionConfiguration对象，并将其设置为默认会话配置。然后，我们创建了一个MySessionDelegate对象，并将其设置为NSURLSession的代理。最后，我们使用这个NSURLSession对象来发送HTTP请求。

4. 使用NSURLConnection

除了使用NSURLSession来发送HTTP请求，我们还可以使用NSURLConnection。NSURLConnection是IOS早期版本中使用的网络请求类，虽然已经被NSURLSession取代，但在某些情况下仍然有用。

Swift
let request = NSURLRequest(URL: NSURL(string: "https://api.example.com/path")!)
let delegate = MySessionDelegate()
let connection = NSURLConnection(request: request, delegate: delegate)

在上面的代码中，我们创建了一个NSURLRequest对象，并将其传递给NSURLConnection的构造函数，同时也传递了我们的自定义NSURLSessionDelegate。通过这种方式，我们可以使用NSURLConnection来发送HTTP请求，并处理HTTP 401错误。

通过设置NSURLSessionDelegate并实现其代理方法，我们可以捕获HTTP 401错误，并以不同的方式处理，而不是简单地使用默认的错误代码-1012 NSURLErrorUserCancelledAuthentication。无论是使用NSURLSession还是NSURLConnection，我们都可以通过设置自定义的NSURLSessionDelegate来达到这个目的。

在实际开发中，我们可能会根据具体需求，选择不同的处理方式。有时，我们可能会要求用户重新输入凭据或跳转到登录界面。无论如何，了解如何接收HTTP 401错误并进行处理，都是开发IOS应用的重要一步。