diff --git a/scripts/ci/compile-ios.sh b/scripts/ci/compile-ios.sh
index bf71236..15b4e1a 100755
--- a/scripts/ci/compile-ios.sh
+++ b/scripts/ci/compile-ios.sh
@@ -99,9 +99,14 @@ fi
 echo "==> compile-ios: built ${IPA}"
 
 # --- 上传 TestFlight(App Store Connect;本机 .p8 由 key-id 自动定位)---
+# TestFlight 是 App Store 独立分发渠道,上传本身易抖(重复 build 号 / ASC 临时错误);
+# 其失败【不应阻断】web/mac/win/android 的整体发版(见 CLAUDE.md「iOS ... 不阻塞」)。
+# IPA 已产出,上传失败仅告警,可稍后用 altool/Transporter 手动补传同一 IPA。
 echo "==> compile-ios: uploading to TestFlight"
-xcrun altool --upload-app -f "$IPA" -t ios \
+if xcrun altool --upload-app -f "$IPA" -t ios \
   --apiKey "${KEY_ID}" \
-  --apiIssuer "${ISSUER}"
-
-echo "==> compile-ios: done — uploaded build ${BUILD} to TestFlight"
+  --apiIssuer "${ISSUER}"; then
+  echo "==> compile-ios: done — uploaded build ${BUILD} to TestFlight"
+else
+  echo "!! compile-ios: TestFlight 上传失败(build ${BUILD}),不阻断发版;IPA=${IPA} 已产出,可稍后手动补传。" >&2
+fi