SwiftUI更新List时出现 UITableView internal inconsistency 崩溃的原因及解决

已于 2025-06-29 19:46:09 修改
阅读量1.3k 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： 开发疑难秒懂百科 文章标签： swiftui List Section UITableView inconsistency
于 2022-05-16 17:08:55 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/mydo/article/details/124794238
当SwiftUI的List包含复杂项目并更新时，可能导致App崩溃，出现'UITableView internal inconsistency'错误。问题源于尝试在同一刷新周期内同时改变Section和Section内容的顺序。解决方法是错开两者状态改变的时机，通过延时生成每组内Tag数组内容，避免崩溃。通过这种方法，可以成功解决SwiftUI List的排序问题。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

在这里插入图片描述



问题现象

SwiftUI在更新包含复杂项目的List界面时，可能会导致App崩溃，且出现如下错误信息：

Terminating app due to uncaught exception ‘NSInternalInconsistencyException’, reason: ‘UITableView internal inconsistency: encountered out of bounds global row index while preparing batch updates (oldRow=xx, oldGlobalRowCount=xx)’
terminating with uncaught exception of type NSException

为什么会出现这种问题？又该如何解决呢？

这个问题貌似很棘手，其实修复也很简单。

那还等什么呢？

Let’s dive in right now！😎


问题分析

1. 卢克，上源代码！

为了更好的了解事情的全部真相，我们有必要先熟悉一下“案发现场”，从源代码看一下到底有什么问题：


                

                
                
        

    

    
  


        

            

                

                

                了解本专栏
                
                
                  
                订阅专栏 解锁全文
                 
            

        


    



                



	

		

			

				
					
SwiftUI中状态改变未导致视图正确刷新的原因及解决

				
			

			

				

					享受开发，颠倒银河
				

				

					07-04
					
					1157
					
				

			

		

		

			
				
问题现象
SwiftUI中状态发生改变，对应的视图刷新却不正确:

这个现象在Mac里使用SwiftUI开发同样会出现。
到底是什么原因？又该如何解决呢？
Let’s find out!


问题分析
1. 卢克，上代码！
我们的代码很简单，首先定义一个结构，然后创建2个实例:
struct Item: Identifiable {
    let id: Int
    let name: String
}

let item_0 = Item(id: 1, name: "黄飞鸿")
let ite...

			
		

	



                

            
              



	

		

			

				
					
SwiftUI不借助ScrollViewReader和ScrollViewProxy实现List自动滚动到底部

				
			

			

				

					享受开发，颠倒银河
				

				

					08-24
					
					945
					
				

			

		

		

			
				
在本篇博文中您将学到:

 - SwiftUI中读写List滚动位置的玄机到底在哪？
 - 在SwiftUI中读取和设置List滚动位置的几种方法
 - MacOS中如何让List自动滚动到显示内容的底部?
 - iOS完成上述功能有哪些不同的地方?
 - 如何让用户动态决定滚动或停止滚动到List的底部?

			
		

	



              


  
              

                


	

		

			

				
					
UITableView 避免奔溃的数组越界处理方法

				
			

			

				

					Yolanda的专栏
				

				

					05-09
					
					950
					
				

			

		

		

			
				
0x7403d 0x3b36cab7)
libc++abi.dylib: terminating with uncaught exception of type NSException
(lldb)
这个方法objectAtIndex:的说明
- (id)objectAtIndex:(NSUInteger)index
Description    
Returns the object locat

			
		

	





	

		

			

				
					
swift 中内存狂飙的问题（1）

				
			

			

				

					qq_41240287的博客
				

				

					03-24
					
					4484
					
				

			

		

		

			
				
在使用 Swift 语言进行开发的时候，很多朋友会莫名奇妙地遇到内存爆满的问题，明明有 ARC ，明明释放了内存，却还是让程序的内存占用随着循环而一路飙升。

这里其实并不是出现了内存泄露，这其实是ARC的一个机制：在每一个主Runloop结束的时候进行清理。也就是说，它有一套必要的缓存机制——毕竟，实时释放的话谁能保证你的局部变量要不要留下来给后续的代码使用呢？

但显然，这个必要的机制在这个时候成了我们的噩梦，比如说：


func test() {
    for _ in 0..<99...

			
		

	



		

			
		



	

		

			

				
					
UITableView中的visibleCells的用法(visibleCells帮上大忙了)

				
			

			

				

					白雾霾
				

				

					10-30
					
					732
					
				

			

		

		

			
				
这两天遇到一个问题，UITableView中需要加入动画，而且每一行的速度不一样。
刚开始做时把所有的cell都遍历一遍加上动画，后来发现，如果数据很多时，就会出现各种各样的问题，而且没有显示在界面上的cell就没必要再用动画了，毕竟看不到。
后来发现UITableView中有这么一个方法：该方法是获取界面上能显示出来了cell。
- (NSArray *)visibleCells;
vi...

			
		

	





	

		

			

				
					
UITableView相关错误

				
			

			

				

					ShutingChen的专栏
				

				

					08-06
					
					679
					
				

			

		

		

			
				
tableView相关

Assertion failure in -[UITableView dequeueReusableCellWithIdentifier:forIndexPath:]
错误描述


Assertion failure in -[UITableView dequeueReusableCellWithIdentifier:forIndexPath:] /Sourc

			
		

	





	

		

			

				
					
UITableViewCell的显示错误

				
			

			

				

					Jingchuanhe的博客
				

				

					06-29
					
					746
					
				

			

		

		

			
				
uitableviewcell的显示错误，缓存池问题

			
		

	





	

		

			

				
					
SwiftUI隐藏List分隔符的不同方法

				
			

			

				

					享受开发，颠倒银河
				

				

					07-15
					
					505
					
				

			

		

		

			
				
功能需求
在UIKit中隐藏列表分隔符很容易，而在SwiftUI中根据iOS的不同版本，我们也有不同的对策：

如上图所示，我们在SwiftUI中完美隐藏了列表中的分隔符。
那么，究竟如何做到呢？
Let‘s find out！


功能分析
1.  iOS 14 之前的系统
在iOS 14之前的系统里，我们可以使用UIKit中UITableView提供的API来完成列表分隔符的隐藏，考虑到SwiftUI中视图加载的时机，一般我们把隐藏代码放到List的onAppear回调中:
// 需要隐藏分隔符的...

			
		

	





	

		

			

				
					
SwiftUI中如何快速开启和关闭List的编辑状态(Edit Mode)

				
			

			

				

					享受开发，颠倒银河
				

				

					02-22
					
					1482
					
				

			

		

		

			
				
在SwiftUI开发中，我们有时需要编程开启和关闭List的编辑状态，并根据编辑状态调整UI界面，如何实现呢？Let's find out!

			
		

	





	

		

			

				
					
*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Could not

				
			

			

				

					zltianhen的专栏
				

				

					07-03
					
					1万+
					
				

			

		

		

			
				
*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Could not load NIB in bundle: 'NSBundle  (loaded)' with name 'UserinfoOnNavibar'










1.XIB命名

			
		

	





	

		

			

				
					
ios NSInternalInconsistencyException 出现原因以及解决办法

				
			

			

				

					01-03
				

			

		

		

			
				
找到异常原因(异常名为内部不一致异常)
///找到这一行
 Terminating app due to uncaught exception 'NSInternalInconsistencyException'
///继续看下去如:
	reason: 'UITableView dataSource returned a nil cell for row at index path:... ... 
///找到这段英文中出现的自己的类名 如:
>>'

通过异常名字和控制台给出的错误,大致可以分析到是单元行出错(因为tableView使用的代理方法只有初始化的时候赋值是由咱们进行赋值的)
解决

			
		

	





	

		

			

				
					
macOS Pycharm打开报NSInternalInconsistencyException

				
			

			

				

					quincy_zt941的博客
				

				

					01-03
					
					3140
					
				

			

		

		

			
				
macOSPycharm打开报NSInternalInconsistencyException

			
		

	





	

		

			

				
					
***Terminatingappduetouncaughtexception'NSInternalInconsistencyException', reason: 'CouldnotloadNIBi

				
			

			

				

					追梦
				

				

					12-17
					
					1359
					
				

			

		

		

			
				
***Terminatingappduetouncaughtexception'NSInternalInconsistencyException', reason: 'CouldnotloadNIBinbundle: 'NSBundle(loaded)'withname'XXXXViewController''***Firstthrowcallstack: (0x329c63e70x3a6b796

			
		

	





	

		

			

				
					
当程序崩溃的时候怎么办 Part-2

					
热门推荐

				
			

			

				

					
				

				

					07-06
					
					2万+
					
				

			

		

		

			
				
泰然教程组出品，转载请保留出处并通知泰然！翻译：大侠自来也；校对：Iven

原文地址：http://www.raywenderlich.com/10209/my-app-crashed-now-what-part-2

欢迎回到当程序崩溃的时候怎么办 教程！

在这个教程的第一部分，我们介绍了SIGABRT和EXC_BAD_ACCESS错误，并且举例说明了一些使用xcode调试器（X

			
		

	





	

		

			

				
					
NSInternalInconsistencyException‘, reason: ‘No foreground window scene found at startup‘

					
最新发布

				
			

			

				

					BaWangLi的博客
				

				

					01-29
					
					561
					
				

			

		

		

			
				
我在.mm文件中引用这个桥文件 “#import ”,并调用SDK里的方法报错"Use of undeclared identifier xxx",我改成"#import "，虽然可以调用SDK的方法，但是编译报错，SDK类继承的父类报错：“No type or protocol name ‘xxx’”,后来大佬告诉我.mm文件是无法使用swfit的代码,要用.m。.mm文件是无法使用swfit的代码的！

			
		

	





	

		

			

				
					
IOS小知识点8之IOS调试过程错误情况一览

				
			

			

				

					关注IOS、Android网络、音视频编解码、特效、Neon算法优化，DSP等嵌入式驱动开发算法移植
				

				

					10-30
					
					674
					
				

			

		

		

			
				
（1）
Terminating
 app due to uncaught exception 'NSInternalInconsistencyException', reason: '* -[NSCFArray insertObject:atIndex:]: mutating method sent to immutable object'

			
		

	





	

		

			

				
					
terminating with uncaught exception of type NSException

				
			

			

				

					chokshen的博客
				

				

					05-11
					
					1万+
					
				

			

		

		

			
				
项目中遇到一个奇葩的bug，只抛出这一句话，没有任何附加错误提示信息，而且crash堆栈没有定位到具体函数，然后上网搜索各种资料，都没有找到答案。导致此类bug的原因很多，通常是因为粗心造成的，就是写出了错误代码，但是编译器没有检测出来，这里分享一下fix此类bug的方法：首先是通过断点大致确定crash所在的函数，然后仔仔细细地去检查这个函数的每一句代码，任何一个字母都不要放过，然后你会找到答案...

			
		

	





	

		

			

				
					
*** Terminating app due to uncaught exception 'NSUnknownKeyException', reason: '[<WKWebViewConfigura...

				
			

			

				

					weixin_34238633的博客
				

				

					11-21
					
					920
					
				

			

		

		

			
				
问题描述：
　　ionic项目，windows下正常，打包android可正常运行；
　　因为需要打包到iPhone (ios 11.0.1)上测试，将代码拿到Mac OS环境下(重新npm install、platform add ios等)测试的时候，
　　build ios正常、ionic serve正常，但是打包运行到iPhone上的时候，出现应用crash闪退的问题。
　　打开X...

			
		

	





	

		

			

				
					
iOS Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: &#...

				
			

			

				

					weixin_34384557的博客
				

				

					08-16
					
					312
					
				

			

		

		

			
				
刚接触iOS，依照教程操作执行出现错误
Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'unable to dequeue a cell with identifier Cell - must register a nib or a class for the i...

			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

  
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  





	
打赏作者

	

		

		
			
		
		

		

			
大熊猫侯佩

			
赏点钱让我买杯可乐好吗 ;)

		

	

	

			

	

	

    ¥1
    ¥2
    ¥4
    ¥6
    ¥10
    ¥20
	

	

		

			

				

					扫码支付：¥1
				

				

					

					
					获取中
					

				

				

					
					
					扫码支付
				

			

		

		

			
您的余额不足，请更换扫码支付或充值

			
打赏作者

		

	



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值