Xử lý lỗi xác thực Nền tảng Apple của Firebase

Nếu lệnh gọi lại hoàn thành trên các phương thức Authentication nhận được đối số NSError không bằng 0, đã xảy ra lỗi. Để điều phối đến quy trình xử lý lỗi thích hợp logic trong mã sản xuất, kiểm tra mã lỗi dựa trên các lỗi thường gặp và lỗi cụ thể theo phương pháp được liệt kê bên dưới.

Một số lỗi có thể được giải quyết bằng thao tác cụ thể của người dùng, ví dụ: Bạn có thể giải quyết FIRAuthErrorCodeUserTokenExpired bằng cách đăng nhập người dùng và FIRAuthErrorCodeWrongPassword bằng cách yêu cầu người dùng cung cấp mật khẩu chính xác.

Ngoại trừ trường hợp FIRAuthErrorCodeNetworkError hoặc FIRAuthErrorCodeTooManyRequests, thử lại một thao tác không thành công bằng đối số sẽ không bao giờ thành công. Không giả định về việc liệu có hoạt động hay không đã có hiệu lực phía máy chủ.

Khi điều tra hoặc ghi nhật ký lỗi, hãy xem lại từ điển userInfo. FIRAuthErrorNameKey chứa chuỗi tên lỗi trên nhiều nền tảng có thể dùng để xác định lỗi. NSLocalizedDescriptionKey có chứa thông tin mô tả về lỗi. Chiến dịch này mô tả dành cho nhà phát triển chứ không phải người dùng. NSUnderlyingErrorKey chứa lỗi cơ bản đã gây ra lỗi trong nếu có lỗi cơ bản.

Ngoài các trường chính được liệt kê ở trên, có thể có các trường khác trong phần Từ điển userInfo mà bạn có thể thấy hữu ích khi chẩn đoán lỗi.

Mã lỗi thường gặp ở mọi phương thức API

Mã Ý nghĩa
FIRAuthErrorCodeNetworkError Cho biết đã xảy ra lỗi mạng trong khi hoạt động.
FIRAuthErrorCodeUserNotFound Cho biết không tìm thấy tài khoản người dùng. Điều này có thể xảy ra nếu tài khoản người dùng đã bị xoá.
FIRAuthErrorCodeUserTokenExpired Cho biết mã thông báo của người dùng hiện tại đã hết hạn, ví dụ: người dùng có thể đã thay đổi mật khẩu tài khoản trên một thiết bị khác. Bạn phải nhắc người dùng đăng nhập lại trên thiết bị này.
FIRAuthErrorCodeTooManyRequests Cho biết rằng yêu cầu đã bị chặn sau khi số lượng yêu cầu bất thường đã được thực hiện từ thiết bị gọi đến máy chủ Firebase Authentication. Hãy thử lại sau giây lát.
FIRAuthErrorCodeInvalidAPIKey Cho biết ứng dụng đã được định cấu hình bằng một khoá API không hợp lệ.
FIRAuthErrorCodeAppNotAuthorized Cho biết Ứng dụng không được phép sử dụng tính năng Xác thực Firebase bằng khoá API được cung cấp. truy cập Bảng điều khiển API của Google và kiểm tra trong thẻ thông tin đăng nhập để đảm bảo khoá API bạn đang sử dụng có ID gói của ứng dụng được đưa vào danh sách cho phép.
FIRAuthErrorCodeKeychainError Cho biết đã xảy ra lỗi khi truy cập vào chuỗi khoá. Các trường NSLocalizedFailureReasonErrorKey và NSUnderlyingErrorKey trong từ điển NSError.userInfo sẽ chứa thêm thông tin về lỗi gặp phải.
FIRAuthErrorCodeInternalError Cho biết đã xảy ra lỗi nội bộ. Vui lòng báo cáo lỗi với toàn bộ đối tượng NSError.

Mã lỗi cụ thể của phương thức

FIRAuth

findProvidersForEmail:complete:

Mã Ý nghĩa
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng.

signInWithEmail:mật khẩu:hoàn thành:

Mã Ý nghĩa
FIRAuthErrorCodeOperationNotAllowed Cho biết rằng tài khoản email và mật khẩu chưa được bật. Bật các tuỳ chọn này trong phần Xác thực của bảng điều khiển Firebase.
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng.
FIRAuthErrorCodeUserDisabled Cho biết tài khoản của người dùng bị vô hiệu hoá.
FIRAuthErrorCodeWrongPassword Cho biết người dùng đã cố đăng nhập bằng mật khẩu sai.

signInWithCredential:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeInvalidCredential Cho biết thông tin đăng nhập đã cung cấp không hợp lệ. Điều này có thể xảy ra nếu mã đã hết hạn hoặc không đúng định dạng.
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng, nếu thông tin đăng nhập thuộc loại EmailPasswordAuthCredential.
FIRAuthErrorCodeOperationNotAllowed Cho biết rằng các tài khoản có nhà cung cấp danh tính được đại diện bằng thông tin đăng nhập chưa được bật. Bật các tuỳ chọn này trong phần Xác thực của bảng điều khiển Firebase.
FIRAuthErrorCodeEmailAlreadyInUse Cho biết email được xác nhận bởi thông tin đăng nhập (ví dụ: email trong mã truy cập Facebook) đã được sử dụng bởi một tài khoản hiện có và không thể xác thực được bằng phương pháp đăng nhập này. Gọi fetchProvidersForEmail cho email của người dùng này rồi nhắc họ đăng nhập bằng bất kỳ nhà cung cấp dịch vụ đăng nhập nào được trả về. Lỗi này sẽ chỉ xảy ra nếu lỗi "Một tài khoản cho mỗi địa chỉ email" bạn có thể bật chế độ cài đặt này trong bảng điều khiển Firebase trong phần cài đặt của Authentication.
FIRAuthErrorCodeUserDisabled Cho biết tài khoản của người dùng bị vô hiệu hoá.
FIRAuthErrorCodeWrongPassword Cho biết người dùng đã cố đăng nhập bằng mật khẩu không chính xác nếu thông tin đăng nhập thuộc loại EmailPasswordAuthCredential.

signInIdlyWithCompletion:

Mã Ý nghĩa
FIRAuthErrorCodeOperationNotAllowed Cho biết tài khoản ẩn danh không được bật. Bật các tuỳ chọn này trong phần Xác thực của bảng điều khiển Firebase.

signInWithCustomToken:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeInvalidCustomToken Cho biết lỗi xác thực với mã thông báo tuỳ chỉnh.
FIRAuthErrorCodeCustomTokenMismatch Cho biết tài khoản dịch vụ và khoá API thuộc về các dự án khác nhau.

createUserWithEmail:password:complete:

Mã Ý nghĩa
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng.
FIRAuthErrorCodeEmailAlreadyInUse Cho biết rằng email dùng để đăng ký đã tồn tại. Gọi fetchProvidersForEmail để kiểm tra xem người dùng đó đã sử dụng cơ chế đăng nhập nào và nhắc người dùng đăng nhập bằng một trong các cơ chế đó.
FIRAuthErrorCodeOperationNotAllowed Cho biết rằng tài khoản email và mật khẩu chưa được bật. Bật các tuỳ chọn này trong phần Authentication của bảng điều khiển Firebase.
FIRAuthErrorCodeWeakPassword Cho biết đã cố đặt một mật khẩu được coi là quá yếu. Trường NSLocalizedFailureReasonErrorKey trong đối tượng từ điển NSError.userInfo sẽ chứa nội dung giải thích chi tiết hơn có thể hiển thị cho người dùng.

đăng xuất:

Mã Ý nghĩa
FIRAuthErrorCodeKeychainError Cho biết đã xảy ra lỗi khi truy cập vào chuỗi khoá. Các trường NSLocalizedFailureReasonErrorKey và NSUnderlyingErrorKey trong từ điển NSError.userInfo sẽ chứa thêm thông tin về lỗi gặp phải.

FIRUser

Các lỗi thường gặp đối với hoạt động của FIRUser

Mã Ý nghĩa
FIRAuthErrorCodeInvalidUserToken Cho biết rằng mã làm mới (chứa thông tin phiên) của người dùng đã đăng nhập không hợp lệ. Bạn phải nhắc người dùng đăng nhập lại trên thiết bị này.
FIRAuthErrorCodeUserDisabled Cho biết tài khoản của người dùng đã bị vô hiệu hoá và không còn dùng được nữa cho đến khi được bật lại trong bảng điều khiển Người dùng trên bảng điều khiển Firebase.

xác thực lại bằng chứng xác thực:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeInvalidCredential Cho biết thông tin đăng nhập đã cung cấp không hợp lệ. Điều này có thể xảy ra nếu mã đã hết hạn hoặc không đúng định dạng.
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng, nếu thông tin đăng nhập thuộc loại EmailPasswordAuthCredential.
FIRAuthErrorCodeWrongPassword Cho biết người dùng đã cố xác thực lại bằng mật khẩu không chính xác nếu thông tin đăng nhập thuộc loại EmailPasswordAuthCredential.
FIRAuthErrorCodeUserMismatch Cho biết hệ thống đã cố gắng xác thực lại với một người dùng không phải là người dùng hiện tại.
FIRAuthErrorCodeOperationNotAllowed Cho biết rằng các tài khoản có nhà cung cấp danh tính được đại diện bằng thông tin đăng nhập chưa được bật. Bật các tuỳ chọn này trong phần Xác thực của bảng điều khiển Firebase.
FIRAuthErrorCodeEmailAlreadyInUse Cho biết email được xác nhận bởi thông tin đăng nhập (ví dụ: email trong mã truy cập Facebook) đã được một tài khoản hiện có sử dụng và không thể xác thực lại bằng phương pháp đăng nhập này. Gọi fetchProvidersForEmail cho email của người dùng này rồi nhắc họ đăng nhập bằng bất kỳ nhà cung cấp dịch vụ đăng nhập nào được trả về. Lỗi này sẽ chỉ xảy ra nếu lỗi "Một tài khoản cho mỗi địa chỉ email" bạn có thể bật chế độ cài đặt này trong bảng điều khiển Firebase trong phần cài đặt của Authentication.
FIRAuthErrorCodeUserDisabled Cho biết tài khoản của người dùng bị vô hiệu hoá.

updateEmail:complete:

Mã Ý nghĩa
FIRAuthErrorCodeEmailAlreadyInUse Cho biết email đã được một tài khoản khác sử dụng.
FIRAuthErrorCodeInvalidEmail Cho biết địa chỉ email không đúng định dạng.
FIRAuthErrorCodeRequiresRecentLogin Cập nhật email của người dùng là một thao tác nhạy cảm về bảo mật và yêu cầu người dùng phải đăng nhập gần đây. Lỗi này cho biết gần đây người dùng chưa đăng nhập đủ. Để khắc phục, hãy xác thực lại người dùng bằng cách gọi reauthenticateWithCredential:completion: trên FIRUser.

updateMật khẩu:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeOperationNotAllowed Cho biết quản trị viên đã tắt tính năng đăng nhập bằng nhà cung cấp danh tính đã chỉ định.
FIRAuthErrorCodeRequiresRecentLogin Cập nhật mật khẩu của người dùng là một thao tác nhạy cảm về bảo mật và yêu cầu người dùng phải đăng nhập gần đây. Lỗi này cho biết gần đây người dùng chưa đăng nhập đủ. Để khắc phục, hãy xác thực lại người dùng bằng cách gọi reauthenticateWithCredential:completion: trên FIRUser.
FIRAuthErrorCodeWeakPassword Cho biết đã cố đặt một mật khẩu được coi là quá yếu. Trường NSLocalizedFailureReasonErrorKey trong đối tượng từ điển NSError.userInfo sẽ chứa nội dung giải thích chi tiết hơn có thể hiển thị cho người dùng.

linkWithCredential:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeProviderAlreadyLinked Cho biết thao tác cố gắng liên kết một nhà cung cấp thuộc một loại đã được liên kết với tài khoản này.
FIRAuthErrorCodeCredentialAlreadyInUse Cho biết thao tác liên kết với một thông tin đăng nhập đã được liên kết với một tài khoản Firebase khác.
FIRAuthErrorCodeOperationNotAllowed Cho biết rằng các tài khoản có nhà cung cấp danh tính được đại diện bằng thông tin đăng nhập chưa được bật. Bật các tuỳ chọn này trong phần Xác thực của bảng điều khiển Firebase.

Phương thức này cũng có thể trả về mã lỗi liên quan đến updateEmail:completion: và updatePassword:completion: vào FIRUser.

Huỷ liên kếtTừProvider:hoàn tất:

Mã Ý nghĩa
FIRAuthErrorCodeNoSuchProvider Cho biết thao tác huỷ liên kết với một nhà cung cấp không được liên kết với tài khoản.
FIRAuthErrorCodeRequiresRecentLogin Cập nhật email là một thao tác nhạy cảm về bảo mật, yêu cầu người dùng phải đăng nhập gần đây. Lỗi này cho biết gần đây người dùng chưa đăng nhập đủ. Để khắc phục, hãy xác thực lại người dùng bằng cách gọi reauthenticateWithCredential:completion: trên FIRUser.

sendEmailVerifyWithCompletion:

Mã Ý nghĩa
FIRAuthErrorCodeUserNotFound Cho biết không tìm thấy tài khoản người dùng.

xoáWithCompletion:

Mã Ý nghĩa
FIRAuthErrorCodeRequiresRecentLogin Xoá tài khoản người dùng là một thao tác nhạy cảm về tính bảo mật và yêu cầu người dùng phải đăng nhập gần đây. Lỗi này cho biết gần đây người dùng chưa đăng nhập đủ. Để khắc phục, hãy xác thực lại người dùng bằng cách gọi reauthenticateWithCredential:completion: trên FIRUser.