执行本地报表偶发Index was outside the bounds of the array异常

触发原因 #

• RDLC报表引擎内部静态缓存存在线程安全问题：当多线程并发复用同一个LocalReport实例渲染报表时，引擎内部的数组下标计算会出现时序冲突，属于底层引擎的已知偶发bug，重启后缓存清空问题就会临时消失。
• 报表模板内置的自定义Code代码块未做边界校验或线程安全处理：如果用到自定义数组、集合存储中间计算结果，多线程同时调用时会出现访问越界。
• 报表绑定的数据集返回结构不稳定：偶发出现查询返回的字段数量少于模板预定义的字段数量，或者动态列数波动，引擎绑定时取下标超出数组范围。

彻底解决方案 #

• 每次渲染报表都实例化全新的LocalReport对象，禁止复用全局或静态的报表实例，从根源避免多线程共享冲突。
• 对报表渲染逻辑做线程隔离：可以用ThreadLocal<LocalReport>存储每个线程专属的报表实例，或者给核心渲染逻辑加互斥锁，避免并发操作。
• 全量检查报表模板的自定义代码：所有数组、集合访问的位置都加下标边界校验，不要在自定义代码中使用静态变量存储计算过程值，所有中间变量改为函数内局部变量。
• 给数据集返回逻辑增加前置校验：每次查询完数据集后，先校验字段数量、必填字段是否存在，和模板定义的结构一致再传入报表引擎，出现结构异常时提前返回可控提示。
• 升级ReportViewer控件到最新官方版本：微软在新版的Microsoft.ReportingServices.ReportViewerControl系列nuget包中，已经修复了多个并发场景下的数组越界底层bug。

内容的提问来源于stack exchange，提问作者Ammad Amir