Lỗi eas submit iOS thường gặp và cách sửa

Khi eas submit --platform ios thất bại, thông báo lỗi gần như luôn cho bạn biết cần xem ở đâu. Hoặc cấu hình EAS của bạn thiếu, hoặc tài khoản Apple đang chặn, hoặc Apple từ chối file binary. Hai trường hợp đầu sửa trong vài phút, không cần build lại. Trường hợp thứ ba nhận ra nhờ mã ITMS, và gần như luôn cần một bản build mới.

Mình phát hành các app iOS của mình, trong đó có Solys, TradaZen và Nolera, bằng Expo và EAS. Các thông báo trích dẫn ở đây được chép từ mã nguồn của EAS CLI, trên kho GitHub chính thức của Expo, đọc lại ngày 3 tháng 11 năm 2026. Diễn đàn cũ của Expo giờ chuyển hướng sang Discord: mã nguồn vẫn là nguồn đáng tin nhất. Để xem toàn bộ quy trình, từ file eas.json đến lúc gửi duyệt, hãy đọc trước EAS Submit iOS: phát hành app Expo lên App Store. Ở đây, mình tập trung sửa lỗi.

eas submit làm gì, và nó cần gì

Theo tài liệu của Expo, lệnh này gửi file .ipa của bạn lên App Store Connect. Bản build xuất hiện trong TestFlight sau khi Apple xử lý xong, thường mất 10 đến 15 phút. Lệnh này không gửi app của bạn đi duyệt: bước đó bạn vẫn phải làm trong App Store Connect.

Trang của Expo về việc gửi iOS liệt kê ba điều kiện:

• một tài khoản Apple Developer trả phí, bắt buộc cho mọi lần gửi lên App Store;
• bundle identifier trong ios.bundleIdentifier;
• EAS CLI đã cài đặt và đăng nhập vào tài khoản Expo của bạn.

Để gửi mà không cần tương tác, cùng trang đó thêm hai thiết lập:

• ascAppId trong profile submit của eas.json, là số định danh của trang app trên App Store Connect;
• một khóa API App Store Connect, do EAS quản lý hoặc do bạn tự cung cấp. Cách tạo, vai trò và cách thu hồi khóa được trình bày chi tiết trong khóa API App Store Connect (.p8).

Profile tối thiểu chỉ vài dòng. Giá trị dưới đây là giả:

{
  "submit": {
    "production": {
      "ios": {
        "ascAppId": "1234567890"
      }
    }
  }
}

Nếu EAS đã giữ khóa API của bạn, profile này là đủ. Phần lớn app của mình đều như vậy.

Đọc thông báo lỗi: ba nhóm lỗi

Trước khi tìm cách sửa, hãy xác định lệnh dừng ở thời điểm nào. Bảng này là khung mình áp dụng mỗi lần thất bại.

Thời điểm thất bại	Nhóm lỗi	Cần build mới?
Trước khi gửi bất cứ thứ gì	Cấu hình EAS	Không
Kết nối với Apple, tạo trang app	Tài khoản Apple	Không
Sau khi gửi, mã ITMS-90xxx	Binary bị từ chối	Gần như luôn có

Chi tiết nằm trên trang của lần submit, trong dashboard của Expo. Expo khuyên đọc log ở đó và tìm khung “Build Annotations”, nơi báo các nguyên nhân thất bại thường gặp. Trong terminal, tùy chọn --verbose luôn hiển thị log của EAS Submit, theo tài liệu tham chiếu EAS CLI.

Lỗi cấu hình EAS

“Set ascAppId in the submit profile (eas.json) or re-run this command in interactive mode.”

Bạn chạy lệnh với --non-interactive, ví dụ trong CI, và profile của bạn không có ascAppId. Mã của EAS CLI khi đó sẽ dừng: nó không thể hỏi bạn, cũng không thể tạo trang app thay bạn.

Cách sửa: chép số định danh trang app vào ascAppId. Expo chỉ chỗ tìm: trong App Store Connect, mở app của bạn, rồi vào App Information. Đó là trường Apple ID, dưới General Information, một con số khoảng mười chữ số. Nó không phải email Apple của bạn, cũng không phải bundle identifier.

Với Nolera, khi chưa có ascAppId, lệnh cứ đòi mình một phiên đăng nhập Apple Developer, mà phiên này thì hết hạn. Từ khi có số này trong eas.json, việc gửi không hỏi gì nữa.

Hãy thêm ascAppId trước khi build, không phải sau. Cho đến SDK 57, fingerprint do Expo tính luôn bao gồm eas.json. Với Vigie, có runtime version theo chính sách fingerprint, việc thêm số này sau khi build đã làm thay đổi fingerprint: một bản update phát hành sau đó sẽ không bao giờ đến được bản build đã cài. Từ SDK 58, preset mặc định của fingerprint, balanced, bỏ qua eas.json, theo changelog của Expo.

“App Store Connect API Keys cannot be set up in --non-interactive mode.”

Profile của bạn không có khóa, và EAS cũng không có khóa nào gắn với app của bạn. Expo nói rõ: ở chế độ không tương tác, lệnh không thể hỏi bạn khóa, nên thất bại với thông báo này.

Có hai cách sửa:

• Để EAS tạo và giữ khóa. Chạy một lần eas credentials --platform ios ở chế độ tương tác trên máy của bạn, và để nó cấu hình một khóa API App Store Connect cho app.
• Tự cung cấp khóa trong ascApiKeyPath, ascApiKeyIssuerId và ascApiKeyId. Theo tài liệu tham chiếu eas.json, ba trường này nhận biến môi trường, như $ASC_API_KEY_PATH.

Ở app gần nhất của mình, tùy chọn --auto-submit đòi Apple ID để tạo khóa gửi. Mình đã đặt ba trường của khóa riêng vào profile trong bản làm việc local, không bao giờ commit. Sau đó mình gửi bản build đã xong bằng --id và --non-interactive.

“EXPO_APPLE_APP_SPECIFIC_PASSWORD must be in the format xxxx-xxxx-xxxx-xxxx, where x is a lowercase letter.”

Biến này chứa thứ khác ngoài mật khẩu dành riêng cho app, thường chính là mật khẩu Apple của bạn. EAS CLI kiểm tra định dạng này trước khi gửi.

Theo trang hỗ trợ của Apple, mật khẩu dành riêng cho app được tạo trên account.apple.com, mục App-Specific Passwords, khi đã bật xác thực hai yếu tố. Nó bị thu hồi ngay khi bạn đổi mật khẩu tài khoản Apple. Expo đánh giá phương pháp này kém an toàn hơn khóa API, phương pháp mặc định và được khuyên dùng.

Lỗi tài khoản Apple

“… agree to the latest Program License Agreement in your developer account.”

Thông báo đầy đủ bắt đầu bằng “You currently don't have access to this membership resource”. Phía Apple, phản hồi gốc có thể chứa “Unable to process request - PLA Update available”. Các bước gửi mới của EAS thì thường hiển thị “A required Apple agreement is missing or has expired”.

Nguyên nhân giống nhau: Apple đã cập nhật một hợp đồng, và chưa ai chấp nhận. Chỉ chủ tài khoản, tức Account Holder, mới chấp nhận được hợp đồng, theo bảng vai trò của Apple. Mã của EAS yêu cầu người này vào trang Business của App Store Connect, rồi nếu Apple đề nghị, vào tài khoản của họ trên developer.apple.com. Sau đó chạy lại lệnh. Hợp đồng cho app trả phí có hướng dẫn riêng: Paid Apps Agreement trong App Store Connect.

“App Store Connect rejected the API authentication credentials.”

Apple trả về lỗi 401, NOT_AUTHORIZED. EAS nêu ba nguyên nhân: khóa không còn hoạt động, khóa thuộc một tài khoản App Store Connect khác, hoặc Key ID, nội dung khóa hay Issuer ID bị sai.

Kiểm tra hai định danh trong App Store Connect, menu Users and Access, tab Integrations. Theo Apple, Issuer ID hiển thị ở đầu trang, còn Key ID nằm trong danh sách khóa đang hoạt động. Khóa đã thu hồi không bao giờ kích hoạt lại được. Apple hiển thị nó 30 ngày dưới mục Revoked: bạn phải tạo khóa mới.

“App Store Connect app for application identifier … was not found.”

Không tìm thấy trang app mà ascAppId trỏ tới với khóa của bạn. EAS yêu cầu bạn kiểm tra lại số này, và kiểm tra khóa có quyền truy cập app trong đúng tài khoản. Nó còn liệt kê vài app mà khóa này thấy được. Với công cụ gửi của Apple, cùng vấn đề này hiện ra dưới dạng “No suitable application records were found”.

Có ba nguyên nhân hay gặp, trong đó hai cái được nêu trong luồng thảo luận này trên diễn đàn Apple:

• Trang app chưa tồn tại. Hãy tạo nó trong App Store Connect, hoặc bỏ ascAppId để lệnh tự tạo.
• Số này đến từ tài khoản khác. Bạn đã chép ascAppId của một team khác, hoặc của một dự án khác.
• Người dùng không có quyền truy cập app. Một App Manager hay Developer có thể bị giới hạn ở một số app. Còn khóa team thì truy cập được mọi app của tài khoản.

“… is not available to team” hoặc “… is not available to provider”

Thông báo này xuất hiện khi EAS tạo trang app thay bạn, vì không có ascAppId. Bundle identifier đã bị một team khác dùng. EAS yêu cầu bạn đổi nó trong cấu hình app, rồi chạy lại.

“App name "…" is already taken. Using generated name "…"”

Đây không phải lỗi. Khi tên đã có người dùng trên App Store, EAS thêm sáu ký tự ngẫu nhiên và thử lại, tối đa năm lần. Bạn sẽ đổi tên trang app sau trong App Store Connect. Để tránh chuyện này, hãy điền appName và language trong profile trước lần gửi đầu tiên: nếu không có language, ngôn ngữ chính mặc định là en-US.

Lỗi binary: các mã ITMS

Sau khi gửi, Apple xử lý bản build. Nếu bị từ chối, log sẽ nêu một hoặc nhiều mã ITMS. Đây là những mã mà bước gửi của EAS nhận diện và giải thích:

Mã ITMS	Apple từ chối điều gì	Cách sửa
90189	Số build đã được dùng	autoIncrement
90062, 90186, 90478	Version đã đóng hoặc đã bị vượt qua	Tăng version
90683	Thiếu câu giải thích quyền truy cập	ios.infoPlist
90725	SDK iOS quá cũ	Image iOS hoặc SDK Expo
90054, 90055	Bundle khác với trang app được nhắm tới	Sửa ascAppId
90022, 90023, 90391, 90713	Icon thiếu hoặc khai báo sai	Xem lại icon
90771	Thiếu định danh tác vụ nền	ios.infoPlist

Ba lưu ý rút ra từ các thông báo này:

• Số build là duy nhất cho mỗi version. Với 90189, EAS khuyên đặt "autoIncrement": true trong eas.json. Mọi thứ có trong số build và version.
• Với 90725, EAS khuyên chọn image iOS mới hơn trong eas.json, và nếu cần thì chuyển sang một SDK Expo còn được hỗ trợ.
• Với 90771, Info.plist của bạn khai báo background mode processing, nhưng không có khóa BGTaskSchedulerPermittedIdentifiers.

Trừ 90054 và 90055, nơi chỉ cần nhắm đúng trang app hoặc một bản build khác, cách sửa đụng đến binary: build lại, rồi gửi lại. Hai mã có hướng dẫn riêng: ITMS-90683 với Expo và ITMS-90725.

Cuối tháng 9 năm 2026, một bản build của Solys bị từ chối lúc gửi vì ITMS-90683. Mình đã xóa một câu giải thích quyền truy cập ảnh khi dọn file cấu hình. Solys không dùng ảnh, nhưng một thư viện trong dự án có gọi API Photos của iOS. Apple phân tích binary, không phải cách dùng thực tế: từ đó, mình không bao giờ xóa những câu này nữa.

Còn trạng thái Missing Compliance thì không phải lỗi gửi. Nó thiếu phần khai báo của bạn về mã hóa, được giải thích trong hướng dẫn phát hành với EAS.

Check-list của mình trước mỗi lần gửi

• ascAppId có trong profile submit, được thêm trước khi build.
• Khóa API do EAS quản lý, hoặc ba trường của nó trỏ tới một file .p8 để ngoài repo.
• Account Holder đã chấp nhận các hợp đồng mới nhất trong App Store Connect.
• autoIncrement đang bật, cùng với "appVersionSource": "remote", được Expo khuyên dùng từ EAS CLI 12.
• version lớn hơn version được duyệt gần nhất.
• Mỗi API nhạy cảm có trong binary đều có câu giải thích quyền truy cập.
• Với app mới, appName và language đã được điền trước lần gửi đầu tiên.

Gửi app đầu tiên mà không bị kẹt

Lệnh này chỉ là một bước. iOS & Android Kit xuất phát từ code khởi đầu của các app của mình, có cả subscription, và đi qua bốn bước đến App Store, theo nhịp độ của bạn.

Nếu bạn đang chuẩn bị ra mắt app đầu tiên, làm bài chẩn đoán miễn phí: nó cho bạn biết điều gì thực sự đang cản bạn và gửi bạn check-list chống bị Apple từ chối của mình. Về trang app, ảnh chụp màn hình và việc duyệt, trang phát hành ứng dụng lên App Store đi lại từng bước.

Câu hỏi thường gặp

Tại sao eas submit chỉ thất bại trong CI?

Ở chế độ --non-interactive, lệnh không thể hỏi bạn gì cả. Nó cần ascAppId trong profile và một khóa API đã gắn với app, hoặc ba trường của khóa trong eas.json. Trên máy bạn, nó sẽ hỏi bạn những điều này.

Có cần build lại sau một lỗi eas submit không?

Chỉ khi Apple từ chối binary, kèm mã ITMS. Ngoại lệ: với ITMS-90054 và 90055, bản build nhắm sai trang app, chỉ cần gửi lại sang đúng trang. Lỗi cấu hình và lỗi tài khoản được sửa trong eas.json, trong App Store Connect hoặc trong tài khoản Apple của bạn. Sau đó bạn gửi lại chính bản build đó, ví dụ với --latest hoặc --id.

Xem log của một lần gửi EAS Submit ở đâu?

Trên trang của lần submit, trong dashboard của Expo. Expo khuyên đọc log ở đó và khung “Build Annotations”. Trong terminal, thêm --verbose để luôn hiển thị log.

Có dùng được eas submit với tài khoản Apple miễn phí không?

Không. Expo yêu cầu tài khoản Apple Developer trả phí để gửi app lên App Store. Tài khoản miễn phí cho phép thử trên iPhone của chính bạn, không cho dùng App Store Connect.

Nên cấp vai trò nào cho khóa API dùng với eas submit?

Hướng dẫn của Expo cấp vai trò Admin cho khóa. Theo bảng vai trò của Apple, việc gửi build cũng mở cho vai trò App Manager và Developer. Các bản build Expo của mình chạy với một khóa team có vai trò App Manager. Chỉ Account Holder và Admin mới tạo được khóa team.

“Increment Build Number” trong EAS nghĩa là gì?

Apple đã từ chối bản build với mã ITMS-90189: số build này đã tồn tại cho version này. Bật "autoIncrement": true trong eas.json, hoặc tăng ios.buildNumber, rồi build lại.