Excel导出常见问题

excel导出其实不算什么难事

在网上copy下模板代码，填充自己的业务数据，提供一个http接口基本就可以得到你要导出的数据了。

但是，凡事都有例外，截止今天，excel导出我遇到的主要是两大类问题

1、大数据量的excel数据，比如几十万条甚至更多的数据导出

2、因为excel中内容的问题，导致导出后的excel不能直接打开，报错“由于一些内容不可取，Excel无法打开xxx.xlsx。是否要打开并修复此工作簿?”

针对第一种大数据量问题，我遇到的主要问题是excel存储的记录上限和导出超时等问题

解决方法是将导出格式为xls升级为xlsx，xls每个sheet最多支持65536条记录，xlsx最多支持1048576条记录；超时则可以采用前端直接返回，后端异步取数据并导出的方式避免超时。

这种情况不是今天要介绍的重点，今天要介绍的第二种情况的解决思路。

需求描述

1、层级关系最多为四级

2、对于相同层级,如果内容相同需要纵向合并单元格，空白行不需要合并

3、样例数据如下所示

一级目录1,二级目录1,三级目录1,四级目录2,一级目录1,二级目录1,三级目录3,一级目录1,二级目录1,三级目录5,一级目录1,二级目录3,一级目录1,二级目录5,三级目录5,一级目录2,二级目录2,三级目录2,一级目录2,二级目录2,三级目录3,一级目录2,二级目录4,三级目录4,一级目录2,二级目录7,一级目录3,二级目录6,三级目录4,一级目录3,二级目录6,三级目录10,一级目录4,一级目录5,二级目录8,三级目录6,

解决思路

将上面样例数据存入一个集合中，遍历每条记录并存放到相应的单元格。

如果不需要合并单元格，到这里，就可以提供导出的Excel了。

但是重点是合并单元格。

遇到的问题

初步排查

自认为代码已经就位，调用接口，Excel文件也成功下载了，结果打开的那一刻一个对话框让我头疼了一下午。

报错信息如下

第一反应是肯定数据错乱了，估计是单元格之间相互挤占，数据肯定也是不堪入目。

但是我按照智能的Excel提示，点击“打开并修复”后发现，数据没有我想的那么糟，甚至仔细看看，发现居然没有问题。

有点小激动的同时，心里还是有点不爽，总不能让别人每次导出的时候都使用这个智能的“打开并修复”功能才能看导出的数据吧。

但是光从这个报错信息来看确实没有什么线索，于是网上找了一通与“由于一些内容不可取，Excel无法打开xxx.xlsx。是否要打开并修复此工作簿?”有关的解决方法。虽然有不少人遇到过这样的问题，但是引起问题的原因不太一样，有些是因为sheet的命名包含特殊字符，有些是导出的Excel内容中有非法字符，还有说要在response的header中加入Content-length字段的。

进一步排查

搜了一通，没有什么进展，这时候想起来在刚刚点击“打开并修复”后，还弹出了一个对话框，于是点击对话框中的查看

得到线索如下

    
    
     
      修复结果到 xxx.xml
     
     
在文件“/Users/jackie/Downloads/xxx.xlsx”中检测到错误
     
      
       已删除的记录: /xl/worksheets/sheet1.xml 的 合并单元格
      
     
    

排除了前面提到的种种非法字符的原因，看到线索里的“合并单元格”，基本可以断定这是因为在合并单元格的过程中出了问题。

寻找问题根本原因

结合合并单元格导致Excel表格无法打开的症状在网上搜索一通

我将下载的Excel表格的后缀从xlsx改为zip并打开

打开sheet1.xml文件，找到mergeCells标签，将其内容拷贝到XML在线格式化工具中查看

经过人眼搜索，终于发现了问题所在

...    
        
        ...

这里显然出现了覆盖合并的情况，进而导致打开Excel报错的情况（后面经过测试发现，重复合并单元格也会出现同样的报错信息）

顺着这个思路，排查代码，不断调试测试，考虑各种情况下的合并单元格场景，最终搞定了这个稍稍复杂的合并单元格的Excel导出功能。

一点思考

虽然知道是合并单元格导致的问题，但是在实际调整代码时花费了几乎一个下午，曾经一度头大到不想思考。

回头想想，在这个问题上有两大收获。

1、排查问题的思路很重要

问题的现象已经摆在眼前，排查了不是非法字符的原因，就应该寻找其他原因

利用一切可以利用的手头信息比如上面简短而关键的报错日志信息。

活用搜索引擎，这种问题肯定已经有前人踩过雷，去看下他们是怎么排雷的就好，不用自己再去研究排雷的具体方法了。

2、写代码之前先想好

现在想想这段合并单元格的代码是不是可以写的更加漂亮，我想应该是可以的，但是能不能从30行精简为10行甚至5行，我想这不太可能。

因为这个导出合并时会遇到各种情况，比如连续相同的单元格何时合并，空白行如何保证不合并，某空白行区域前和后又如何实现合并等问题。

所以，写这段代码前应该先梳理所有可能的场景包括一些特殊情况，尽其所能罗列所有的情况，这样才能保证在应对各种情形的数据时正常导出。

代码稍后我会放到项目rome里

项目地址：

对了，导出效果图呈上

如果您觉得阅读本文对您有帮助，请点一下“推荐”按钮，您的“推荐”将是我最大的写作动力！如果您想持续关注我的文章，请扫描二维码，关注JackieZheng的微信公众号，我会将我的文章推送给您，并和您一起分享我日常阅读过的优质文章。