NetBeans环境下Java自定义打印尺寸不生效、始终输出A4的问题求助

• 修正打印样式的作用域与规则写法
  多数场景下失效的核心原因，是自定义的@page纸张规则没有独立放在打印专属媒体查询块中，被浏览器内置的A4默认规则覆盖。正确的规则写法需要注意两点：
  • 纸张尺寸的单位必须使用mm、in这类印刷通用单位，不能使用px，否则会被浏览器直接忽略、回落到默认A4规格
  • 规则示例：

    @media print {
      @page {
        size: 148mm 210mm; /* 替换为实际需要的自定义宽高 */
        margin: 10mm;
      }
    }
    

• 排查打印流程的参数传递链路
  如果是基于前端SDK、无头浏览器或者后端渲染引擎实现的打印，要核对自定义的宽高、边距参数是否真正传入了最终的渲染配置：
  常见的逻辑漏洞是参数定义在局部作用域，渲染函数读取的是全局内置的A4默认参数，自定义值根本没有进入生效链路，比如：

  // 错误写法：定义了自定义参数但未关联到打印配置
  const customPageSize = { width: 148, height: 210, margin: 10 }
  function triggerPrint() {
    // 渲染配置未引入customPageSize，直接走内置默认值
    printRenderer.render({ target: printAreaDom })
  }
  

• 关闭浏览器的自动尺寸适配逻辑
  无论前端还是无头打印场景，都需要给打印配置显式加上preferCSSPageSize: true，强制浏览器优先读取CSS中定义的自定义纸张尺寸，避免被系统默认的A4选项自动覆盖。同时要确认自定义的纸张尺寸在当前连接的打印机支持的可打印范围内，如果尺寸超出阈值，打印机驱动会自动匹配最接近的A4规格输出。
• 校验尺寸换算的精度错误
  如果代码中使用px作为尺寸单位，要按照96dpi的基准换算：1mm≈3.78px，避免因为换算偏差把自定义尺寸错算到A4的规格区间，触发驱动的自动匹配逻辑输出A4。

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