我来帮你搞定这个Apache POI设置Word表格粗边框的问题！你遇到的STBorder.THICK无效、THIN_THICK_SMALL_GAP显示异常，以及用setInsideHBorder缺外边框的问题，都可以通过以下方法解决：

原因分析 #

出现这些问题主要是因为：

• 仅设置边框样式（val）不够，Word的边框渲染还依赖**边框宽度（sz）**属性，尤其是THICK这类需要明确粗细的样式；
• 用XWPFTable的API时，你只设置了内部边框，没有显式设置外边框，所以外边框缺失。

解决方案1：直接操作CTTblBorders（底层XML） #

这种方法直接操作Word的底层XML结构，需要同时设置边框样式和宽度：

import java.math.BigInteger;
import org.apache.poi.xwpf.usermodel.XWPFTable;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTblBorders;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTTblPr;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STBorder;

// 获取表格样式对象
CTTblPr tblpro = table.getCTTbl().getTblPr();
CTTblBorders borders = tblpro.addNewTblBorders();

// 设置外边框（下）
var bottomBorder = borders.addNewBottom();
bottomBorder.setVal(STBorder.THICK);
bottomBorder.setSz(BigInteger.valueOf(48)); // 6磅（48/8），对应粗边框
bottomBorder.setColor("000000");

// 设置外边框（左）
var leftBorder = borders.addNewLeft();
leftBorder.setVal(STBorder.THICK);
leftBorder.setSz(BigInteger.valueOf(48));
leftBorder.setColor("000000");

// 设置外边框（右）
var rightBorder = borders.addNewRight();
rightBorder.setVal(STBorder.THICK);
rightBorder.setSz(BigInteger.valueOf(48));
rightBorder.setColor("000000");

// 设置外边框（上）
var topBorder = borders.addNewTop();
topBorder.setVal(STBorder.THICK);
topBorder.setSz(BigInteger.valueOf(48));
topBorder.setColor("000000");

// 设置内部水平边框
var insideHBorder = borders.addNewInsideH();
insideHBorder.setVal(STBorder.THICK);
insideHBorder.setSz(BigInteger.valueOf(48));
insideHBorder.setColor("000000");

// 设置内部垂直边框
var insideVBorder = borders.addNewInsideV();
insideVBorder.setVal(STBorder.THICK);
insideVBorder.setSz(BigInteger.valueOf(48));
insideVBorder.setColor("000000");

注意：Word的边框宽度单位是1/8磅，所以sz的值是磅数乘以8，比如6磅对应48。

解决方案2：使用XWPFTable的API（更简洁） #

如果你觉得操作底层XML太麻烦，可以用XWPFTable提供的API，同时设置外边框和内部边框：

import org.apache.poi.xwpf.usermodel.XWPFTable;

// 设置外边框：上、下、左、右
table.setTopBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");
table.setBottomBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");
table.setLeftBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");
table.setRightBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");

// 设置内部边框：水平、垂直
table.setInsideHBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");
table.setInsideVBorder(XWPFTable.XWPFBorderType.THICK, 6, 0, "000000");

这里的参数依次是：边框类型、磅数、间距（0即可）、颜色（十六进制）。

关于THIN_THICK_SMALL_GAP的问题 #

如果你需要THIN_THICK_SMALL_GAP样式，同样需要设置正确的宽度值来呈现粗细对比：

var border = borders.addNewBottom();
border.setVal(STBorder.THIN_THICK_SMALL_GAP);
border.setSz(BigInteger.valueOf(32)); // 4磅，调整这个值可以让粗细差异更明显
border.setColor("000000");

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