使用Apache POI设置Excel指定单元格为文本格式失效的问题求助

我太懂这种挫败感了——明明想把SQL里nvarchar类型（看起来像数字）的内容存成Excel的文本格式，结果Apache POI写进去后还是自动变成了数字格式，折腾半天都没效果，对吧？我来帮你拆解问题，一步步解决。

首先，先看看你现有代码里的几个小问题：

• 你用了加单引号的方式cell.setCellValue("'" + value)，但这种方式在POI里不一定靠谱——Excel的隐藏单引号是手动输入时的小技巧，但POI处理程序写入时，这个逻辑可能被自动解析，反而达不到预期效果。
• 另外，你有没有检查过从数据库取出来的value实际类型？如果JDBC驱动自动把nvarchar里的数字字符串转成了Integer或Double类型，那哪怕你设置了文本样式，POI也会把它当成数字写入，直接覆盖你的格式设置。

接下来给你两个核心的解决步骤，结合修正后的代码：

第一步：确保从数据库取出的是纯字符串类型 #

先排查JDBC的类型转换问题——有些驱动会自作主张把看起来像数字的字符串转成数值类型。你可以在代码里加一行打印，确认值的实际类型：

System.out.println("当前值类型：" + value.getClass().getName());

如果输出是java.lang.Integer或java.lang.Double，那你需要：

• 要么在SQL查询里显式把列转成字符串，比如SELECT CAST(your_column AS CHAR) FROM your_table
• 要么调整JDBC连接参数，禁止自动类型转换（比如MySQL驱动可以加useOldAliasMetadataBehavior=true参数）

第二步：修正Apache POI的代码逻辑 #

确保POI明确把单元格标记为文本格式，并且顺序正确——先设置样式和单元格类型，再传入字符串值，不需要加单引号：

// 注意：DataFormat必须从当前workbook创建，否则样式不生效
DataFormat format = workbook.createDataFormat();
CellStyle textStyle = workbook.createCellStyle();
textStyle.setDataFormat(format.getFormat("@"));

Set<Integer> forceTextIndexes = new HashSet<>();
if ("LE_27".equalsIgnoreCase(excelName)) {
    forceTextIndexes.add(3);
    forceTextIndexes.add(6);
} else if ("LE_28".equalsIgnoreCase(excelName) || "LE_29".equalsIgnoreCase(excelName)) {
    forceTextIndexes.add(3);
    forceTextIndexes.add(4);
}

for (int i = COPY_VALUES_START_INDEX; i < columnValues.length; i++) {
    int cellIndex = WRITE_START_COLUMN + (i - COPY_VALUES_START_INDEX);
    Cell cell = row.createCell(cellIndex);
    Object value = columnValues[i];
    boolean forceAsText = forceTextIndexes.contains(i);

    if (value == null) {
        cell.setCellType(CellType.BLANK);
    } else if (forceAsText) {
        // 先应用文本样式
        cell.setCellStyle(textStyle);
        // 明确设置单元格类型为字符串
        cell.setCellType(CellType.STRING);
        // 直接传入字符串形式的值，不需要加单引号
        cell.setCellValue(value.toString());
    } else {
        // 非强制文本的单元格，按正常逻辑处理
        if (value instanceof Number) {
            cell.setCellValue(((Number) value).doubleValue());
        } else {
            cell.setCellValue(value.toString());
        }
    }
}

代码调整的关键点： #

1. 先创建DataFormat再生成样式，确保样式和当前Workbook绑定，不会因为上下文问题失效。
2. 先设置单元格样式和类型，再传入值——POI的设置顺序会影响最终的单元格属性，把格式相关的设置放在前面更稳妥。
3. 去掉了单引号前缀，直接用value.toString()传入字符串值，配合文本样式和STRING类型，Excel会明确把这个单元格识别为文本格式。

按这个方式调整后，你再试试——应该就能把那些看起来像数字的nvarchar内容，稳稳地存成Excel的文本格式了。

内容来源于stack exchange