作者ervis (Ervis)
看板iOS
標題[心得] CoreNFC 讀西瓜實體卡踩坑紀錄(FeliCa)
時間Mon Feb 9 09:53:03 2026
## 前言
最近在做一個日/韓旅遊記帳 App「旅收」,
收到用戶許願說想用 NFC 感應西瓜卡直接記帳,不用手打金額。
覺得這個方向很有趣就開始研究。
查了一輪資料,網路上幾乎都寫 Suica 的 FeliCa system code 是 88B4,
結果實測完全不是那回事,踩了不少坑,紀錄一下。
環境:iPhone 16 Pro / iOS 26 / Xcode 26.1.1 / CoreNFC
## 踩坑紀錄
### 坑 1:FFFF 萬用碼直接被 Apple 拒絕
FeliCa 有個萬用 system code FFFF,理論上可以偵測所有卡片。
放進 Info.plist → Apple 直接噴 "Invalid system code entry: FFFF"。
所以必須列舉具體的 system codes。
### 坑 2:88B4 超時,拖垮整個 NFC 連線
照網路資料把 88B4 排第一,結果 nfcd daemon 嘗試查詢時直接超時:
```
nfcd: _getIDMFromTag:systemCode:
nfcd: phNciNfc_RspTimeOutCb: Timer expired!
nfcd: Target Lost!!
```
重點是,這個超時不只是「查詢失敗」,它會弱化整個 RF 連線。
後面即使換別的 system code 成功連上,App 也只能送 1-2 個指令就斷線。
### 坑 3:實測 3 張 Suica,全部沒有 88B4
用 requestSystemCode() 查詢卡片支援的系統碼:
```
3 張不同年份的實體 Suica → ["0003", "FE00", "86A7"]
```
沒有一張有 88B4。
目前不確定是所有實體卡都這樣,還是跟卡片世代有關。
手邊沒有 PASMO 可以交叉驗證。
如果有板友手上有不同卡片,很好奇 requestSystemCode 會回什麼。
### 坑 4:服務藏在 system 0003
既然沒有 88B4,那餘額 (0x008B) 跟交易歷史 (0x090F) 在哪?
用 requestService 逐一探測:
```
System 0003:
0x008B (餘額): 存在
0x090F (歷史): 存在
System 86A7:
全部 FFFF(無可用服務)
System FE00:
Common Area,沒有交通相關服務
```
所以交通卡服務的 service codes 跟網路資料一樣(0x008B / 0x090F),
但掛載的 system 不是 88B4 而是 0003。
### 坑 5:Info.plist 順序決定連線穩定性
nfcd 會按照 Info.plist 的順序逐一嘗試 system code。
排錯順序 → 前面的超時 → 連線不穩 → App 讀不到資料。
最終順序:
```xml
<array>
<string>0003</string> <!-- 服務在這,排最前 -->
<string>FE00</string> <!-- Common Area fallback -->
<string>88B4</string> <!-- 標準交通卡(備用) -->
<string>86A7</string> <!-- 無有用服務,排最後 -->
</array>
```
## 最終結果
調整順序後,讀取穩定很多。成功讀到餘額 + 最近的交易紀錄。
每筆交易 16 bytes,包含日期、終端機類型(改札機/超商/自販機)、
進出站代碼、餘額。
目前已經整合到 App 裡面,
靠卡就能把交通費跟超商消費直接匯入帳本。
## 小結
這次最大的收穫是:不要盡信網路資料,實測才是真的。
88B4 在我手上的 3 張 Suica 都不存在,
但 service codes 是一樣的,只是掛在不同的 system 上。
CoreNFC + FeliCa 的中文資源真的很少,
希望這篇能幫到也在研究的人。有問題歡迎推文交流。
PS: 有使用 AI 協助寫作
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 114.35.1.4 (臺灣)
※ 文章網址: https://webptt.com/m.aspx?n=bbs/iOS/M.1770601985.A.B28.html
2F:推 gg90052: 很有潛力的作法,可惜我現在都用apple wallet的suica了 02/09 11:12
3F:推 awdrgyjilp22: 用心給推 雖然看不懂 02/09 11:22
4F:推 a100820: 太神 這真的是免費能用的嗎 02/09 11:24
5F:推 lovebbqjim: 很棒!不知道你有沒有考慮將這些筆記發表在Medium 02/09 11:40
6F:→ lovebbqjim: 或ITHome,應該能讓更多開發者看到 02/09 11:40
7F:推 berserkman: 這簡直記帳者福音 02/09 12:05
8F:推 as209099: 推,感覺也可以發到GitHub 02/09 12:20
9F:推 kpg0427: 看不懂,但推w 02/09 12:47
10F:→ ervis: 感謝 lovebbqjim 建議,我有發表在 iThome, 歡迎來按讚 ^^ 02/09 15:00
11F:→ ervis: 回 a100820: 免費無誤 (app 內有純贊助支持, 但不影響使用) 02/09 15:03
12F:推 ankai: 先跪了 太神 02/09 15:23
13F:推 lmw: 太神了!可惜現在都是用錢包中的西瓜 02/09 15:51
14F:→ ervis: 沒錯,希望 Apple 能夠開放 API 讀取,資料就豐富多了 02/09 16:06
15F:推 ginlom: 推小結:實測才是真的 02/09 16:48
16F:推 ko00385331: 推 02/09 17:54
17F:推 cutejojocat: 推一個持續更新新功能 02/10 01:19
18F:推 y05192c: 實用就給推 介紹給剛好最近要去日本玩的朋友 02/10 03:50
19F:推 Syu: 認真開發給推 02/10 05:22
20F:推 pcmacgyver: 推作者的用心開發 02/10 06:58
21F:推 hymo: 推 02/10 12:07
22F:推 Donaldren: 推推 02/10 12:20
24F:→ sinclaireche: Github上也有相關library 02/10 12:58
25F:推 Ethierz: 推 02/10 13:15
26F:推 love61106: 只能推作者用心 其他就靠板友研究自己摸索了 02/10 17:41
27F:→ ervis: 感謝 sinclaireche 提供資訊,非常完整超棒 02/10 23:43
28F:推 sam749: 推 02/11 02:04
29F:推 linken28: 推用心! 02/11 15:54
30F:推 zhao60: 推推 02/12 00:22
31F:推 stableman302: 推旅收 02/12 07:02