Apache POI生成受保护Excel工作表如何开放列宽调整权限

实现逻辑说明 #

使用Apache POI生成带保护的Excel工作表时，若要开放用户调整列宽的权限，不要单独调用单元格样式维度的lockFormatColumns()方法，该方法作用于单元格锁定属性，不控制工作表保护层面的操作权限。

代码实现 #

根据使用的POI版本选择对应写法：

• 5.0及以上高版本POI，可直接调用封装好的锁配置API：

// 为工作表设置保护密码
sheet.protectSheet("your_sheet_password");
// 开放列宽调整权限
sheet.getLockSettings().setFormatColumnsAllowed(true);

• 低版本POI无对应封装API，需要操作底层XML配置对象实现：

sheet.protectSheet("your_sheet_password");
CTSheetProtection protection = sheet.getCTWorksheet().getSheetProtection();
// 关闭列格式调整的锁定规则
protection.setFormatColumns(false);

常见验证异常排查 #

• 上述实现方案在Microsoft Office 2016及以上全版本环境下验证完全生效，工作表处于保护状态时，用户可正常拖拽调整列宽，其余默认锁定的编辑操作会被正常拦截。
• 若测试时发现功能不生效，先排查打开文件的客户端：Linux环境下使用LibreOffice打开生成的Excel文件时，不会识别该权限配置，列宽调整操作会被锁定，这是LibreOffice对微软Office保护规则的兼容缺陷，不属于代码实现问题。
• 功能验收建议以Microsoft Office客户端的表现为准，若业务需要兼容LibreOffice使用场景，目前POI侧无适配方案，建议在使用说明中明确提示客户端要求。

内容的提问来源于stack exchange，提问作者Rajith K