PDFPageAnalyzerV2 causes recursive os_unfair_lock crash (EXC_BREAKPOINT) on iPadOS 26.5 with PDFView singlePageContinuous

Environment

  • Device: iPad Pro 11-inch 2nd gen (iPad8,9 / A12X)
  • OS: iPadOS 26.5 (23F77)
  • Xcode: 26.3

Issue

App crashes with EXC_BREAKPOINT / SIGKILL when user scrolls through a PDF in PDFView on iPadOS 26.5.

Crash Log (ASI)

"BUG IN CLIENT OF LIBPLATFORM: Trying to recursively lock an os_unfair_lock" Abort Cause 259

Root Cause (from .ips)

Two threads deadlock on os_unfair_lock inside CGPDFPageInsertTableDescriptions:

Thread 0 (main): _os_unfair_lock_recursive_abort CGPDFPageInsertTableDescriptions [PDFPageAnalyzerV2 addTablesFromVisionDocument:documentImage:toPage:withBox:]_block_invoke_2 _dispatch_async_and_wait_invoke ← main thread waiting

Thread (PDFKit.PDFDocument.formFillingQueue): _dispatch_sync_f_slow ← background queue waiting for main thread +[PDFPageAnalyzerV2 addTablesFromVisionDocument:documentImage:toPage:withBox:] +[PDFPageAnalyzerV2 analyzePage:withBox:requestTypes:] -[PDFView visiblePagesChanged:] ← triggered by scrolling

PDFPageAnalyzerV2 dispatches_sync back to the main thread from PDFKit.PDFDocument.formFillingQueue, while the main thread is already blocked in dispatch_async_and_wait for the same operation. This results in a recursive lock on os_unfair_lock in CGPDFPageInsertTableDescriptions → SIGKILL.

Notes

  • PDFPageAnalyzerV2 appears to be a new iOS 26 Vision-based table analysis feature
  • No public API found in PDFKit headers to disable this analysis
  • Workaround: pdfView.usePageViewController(true, withViewOptions: nil) appears to reduce frequency of visiblePagesChanged: triggers

Question

Is there an official API to disable PDFPageAnalyzerV2 table analysis on iOS 26? Is this a known issue with a fix planned?

Hello @YiLung,

As far as I can see, I have not seen this reported yet.

Are you able to create a minimal sample project that reproduces the issue?

Please file a bug report with Feedback Assistant, include your sample project and steps to reproduce the issue.

Once complete, reply with the feedback number, I'll make sure your report is seen by the relevant engineering team.

Thank you.

 Travis

PDFPageAnalyzerV2 causes recursive os_unfair_lock crash (EXC_BREAKPOINT) on iPadOS 26.5 with PDFView singlePageContinuous
 
 
Q