Windows环境下Tomcat 8.5部署Web应用时Barcode生成异常问题

我之前也碰到过几乎一模一样的场景！本地Tomcat跑JasperReports+Barbecue生成条码完全正常，一部署到服务器就只显示占位符，还没报错，这种情况大概率是依赖缺失、字体加载失败或者权限问题，咱们一步步来排查：

1. 先检查Barbecue依赖包是否完整部署 #

本地开发时IDE会自动把依赖包加入classpath，但部署到Tomcat时很容易漏掉：

• 打开服务器上Tomcat的webapps/你的应用名/WEB-INF/lib目录，确认有没有barbecue-1.5-beta.jar（如果有其他关联依赖包比如日志类的，也要一并检查）。
• 如果缺失，把本地开发环境里的对应jar包复制到这个目录，然后重启Tomcat试试——这是最常见的原因，我当初就是漏了这个jar！

2. 排查条码字体的加载问题 #

Barbecue生成条码需要它自带的特殊字体（比如Barcode39、Code128这些），本地Windows系统可能已经包含或者IDE能读取到jar里的字体，但服务器环境可能不行：

• 从barbecue-1.5-beta.jar里提取字体文件（路径一般是net/sourceforge/barbecue/fonts），把这些.ttf文件放到服务器的Tomcatlib目录，或者系统的字体目录（比如Windows服务器的C:\Windows\Fonts）。
• 另外，在JasperReports的报表设计文件（.jrxml）里，明确指定条码组件使用的字体，避免依赖系统默认字体，比如：

  <textField>
      <reportElement x="100" y="50" width="200" height="30"/>
      <textElement>
          <font fontName="Barcode39" size="14"/>
      </textElement>
      <textFieldExpression><![CDATA[$F{barcodeValue}]]></textFieldExpression>
  </textField>
  

3. 检查Tomcat临时目录的读写权限 #

JasperReports和Barbecue生成条码时会在临时目录生成缓存文件，如果Tomcat没有权限读写这个目录，就会静默失败：

• 找到服务器上Tomcat的临时目录，默认是CATALINA_BASE/temp（比如C:\Tomcat8.5\temp）。
• 确保运行Tomcat的用户对这个目录有读写权限，如果权限不足，手动修改目录权限，或者在conf/catalina.properties里修改java.io.tmpdir参数，指定一个有权限的临时目录：

  java.io.tmpdir=C:/Tomcat8.5/custom-temp
  

4. 调高日志级别抓隐藏错误 #

虽然你说没有错误提示，但可能是日志级别太高过滤了关键信息：

• 打开Tomcat的conf/logging.properties，把日志级别调低，比如把java.util.logging.ConsoleHandler.level改成FINE，org.apache.catalina.level改成FINE。
• 重启Tomcat后，查看logs/localhost.log或者catalina.out，里面可能会有字体找不到、IO异常之类的隐藏错误，帮你定位问题。

先从依赖包和字体这两点开始排查，大概率能解决问题！

内容的提问来源于stack exchange，提问作者Mel Haynes Jr