在实际企业应用开发中经常需要将 Excel 报表、采购订单、入库单等文档转换为 PDF 格式以便于存档、打印或分发。相比直接操作 Excel 文件PDF 具有跨平台、防篡改、版面固定等优点。而 LibreOffice 作为一款开源的办公套件提供了强大的命令行转换能力能够高质量地保留 Excel 的复杂样式、图表、公式和排版是 Java 后端实现文档转换的理想选择。本文将详细介绍如何使用 Java 调用 LibreOffice 将 Excel 文件转换为 PDF并提供完整的代码示例、参数说明及常见问题解决方案。比如下面这种复杂excel表格转换pdf就恒麻烦尤其是样式回错乱。下面介绍一种方式来实现windows环境下的无损转换pdflinux只需要安装luinx下的包即可这里不做演示。一、为什么选择 LibreOffice目前主流的 Excel 转 PDF 方案有以下几种方案优点缺点Apache POI iText纯 Java无需安装额外软件样式还原度差对复杂表格、图表支持弱JodConverter封装了 LibreOffice 的调用API 友好同样需要安装 LibreOffice但依赖较重直接调用 LibreOffice 命令行样式保真度最高免费开源跨平台需要安装 LibreOffice依赖外部进程在企业级应用中样式保真度往往是最重要的指标。LibreOffice 能够完美呈现 Excel 中的字体、颜色、边框、合并单元格、公式计算结果、甚至嵌入式图表这是其他纯 Java 方案难以比拟的。因此推荐使用 Java 调用 LibreOffice 命令行的方式。二、环境准备2.1 安装 LibreOfficeWindows从 LibreOffice 官网 下载 LibreOffice | LibreOffice 简体中文官方网站 - 自由免费的办公套件下载安装包默认安装路径为C:\Program Files\LibreOffice\program\soffice.exeLinux (Ubuntu/Debian)sudo apt install libreoffice -yLinux (CentOS/RHEL)sudo yum install libreoffice -ymacOS通过 Homebrew 安装brew install --cask libreoffice安装后在终端执行soffice --version验证是否成功。2.2 Java 环境JDK 17及以上版本任何 Java 框架均可Spring Boot、普通 Maven 项目等三、核心原理LibreOffice 提供无界面headless模式可以通过命令行参数完成文档格式转换而不启动图形界面。Java 通过ProcessBuilder或Runtime.exec()调用系统命令执行 LibreOffice 的转换指令然后读取生成的 PDF 文件即可。基本命令格式如下bashsoffice --headless --convert-to pdf --outdir /output/dir /path/to/input.xlsx--headless无界面模式必需--convert-to pdf转换为 PDF--outdir输出目录最后为输入文件路径四、Java 实现步骤4.1 创建转换器类javapublic class LibreOfficeConverter { private static final Logger log LoggerFactory.getLogger(LibreOfficeConverter.class); private String sofficePath; private int timeoutSeconds; public LibreOfficeConverter(String sofficePath, int timeoutSeconds) { this.sofficePath sofficePath; this.timeoutSeconds timeoutSeconds; } public String excelToPdf(String excelPath, String outputDir) throws Exception { // ... 方法实现见之前的代码 File excelFile new File(excelPath); if (!excelFile.exists()) { throw new Exception(Excel文件不存在 excelPath); } File outputDirFile new File(outputDir); if (!outputDirFile.exists()) { outputDirFile.mkdirs(); } String absoluteExcelPath excelFile.getAbsolutePath(); String absoluteOutputDir outputDirFile.getAbsolutePath(); String command String.format( %s --headless --convert-to pdf:writer_pdf_Export --outdir %s %s, sofficePath, absoluteOutputDir, absoluteExcelPath ); log.info(LibreOffice转换命令{}, command); ProcessBuilder processBuilder new ProcessBuilder(); if (System.getProperty(os.name).toLowerCase().contains(windows)) { processBuilder.command(cmd.exe, /c, command); } else { processBuilder.command(bash, -c, command); } processBuilder.environment().put(LANG, zh_CN.UTF-8); processBuilder.environment().put(LANGUAGE, zh_CN.UTF-8); processBuilder.redirectErrorStream(true); Process process null; try { process processBuilder.start(); StringBuilder output new StringBuilder(); try (BufferedReader reader new BufferedReader( new InputStreamReader(process.getInputStream(), UTF-8))) { String line; while ((line reader.readLine()) ! null) { output.append(line).append(\n); } } boolean finished process.waitFor(timeoutSeconds, TimeUnit.SECONDS); if (!finished) { process.destroyForcibly(); throw new Exception(LibreOffice转换超时 timeoutSeconds 秒); } int exitCode process.exitValue(); if (exitCode ! 0) { throw new Exception(PDF转换失败退出码 exitCode); } String excelBaseName excelFile.getName(); int dotIndex excelBaseName.lastIndexOf(.); String pdfName (dotIndex 0 ? excelBaseName.substring(0, dotIndex) : excelBaseName) .pdf; String pdfPath absoluteOutputDir File.separator pdfName; return pdfPath; } finally { if (process ! null process.isAlive()) { process.destroyForcibly(); } } } public boolean isAvailable() { try { // 方法1直接检查文件是否存在 File sofficeFile new File(sofficePath); System.out.println(检查路径: sofficeFile.getAbsolutePath()); System.out.println(文件是否存在: sofficeFile.exists()); System.out.println(是否可读: sofficeFile.canRead()); System.out.println(是否可执行: sofficeFile.canExecute()); if (!sofficeFile.exists()) { // 尝试常见路径 String[] commonPaths { D:/installsoftware/program/soffice.exe, D:\\installsoftware\\program\\soffice.exe, }; for (String path : commonPaths) { File testFile new File(path); if (testFile.exists()) { sofficePath path; sofficeFile testFile; System.out.println(找到LibreOffice: path); break; } } if (!sofficeFile.exists()) { System.err.println(未找到LibreOffice可执行文件); return false; } } // 方法2直接执行命令使用 ProcessBuilder ProcessBuilder pb new ProcessBuilder( sofficeFile.getAbsolutePath(), --version ); pb.redirectErrorStream(true); Process process pb.start(); // 读取输出 StringBuilder output new StringBuilder(); try (BufferedReader reader new BufferedReader( new InputStreamReader(process.getInputStream(), UTF-8))) { String line; while ((line reader.readLine()) ! null) { output.append(line); } } boolean finished process.waitFor(5, TimeUnit.SECONDS); if (finished process.exitValue() 0) { System.out.println(LibreOffice版本: output.toString()); return true; } else { System.err.println(退出码: process.exitValue()); return false; } } catch (Exception e) { System.err.println(检查失败: e.getMessage()); e.printStackTrace(); return false; } } }javaRestController RequestMapping(/api/convert) public class ExcelToPdfController { Value(${libreoffice.path}) private String sofficePath; Value(${libreoffice.timeout:300}) private int timeout; Value(${file.upload-dir:./uploads}) private String uploadDir; Value(${file.pdf-dir:./pdfs}) private String pdfDir; /** * 上传Excel并转换为PDF */ PostMapping(/excel-to-pdf) public ResponseEntity? convertExcelToPdf(RequestParam(file) MultipartFile file) { Path excelFilePath null; try { // 使用绝对路径并规范化路径 Path uploadPath Paths.get(uploadDir).toAbsolutePath().normalize(); Path pdfPath Paths.get(pdfDir).toAbsolutePath().normalize(); // 打印调试信息 System.out.println(上传目录绝对路径: uploadPath); System.out.println(PDF目录绝对路径: pdfPath); // 创建目录 if (!Files.exists(uploadPath)) { Files.createDirectories(uploadPath); System.out.println(创建上传目录: uploadPath); } if (!Files.exists(pdfPath)) { Files.createDirectories(pdfPath); System.out.println(创建PDF目录: pdfPath); } // 保存上传的Excel文件 String originalFilename file.getOriginalFilename(); System.out.println(原始文件名: originalFilename); // 处理文件扩展名 String ext ; if (originalFilename ! null originalFilename.contains(.)) { ext originalFilename.substring(originalFilename.lastIndexOf(.)); } else { ext .xlsx; } String fileName UUID.randomUUID().toString() ext; excelFilePath uploadPath.resolve(fileName); // 确保父目录存在 Files.createDirectories(excelFilePath.getParent()); // 保存文件 file.transferTo(excelFilePath.toFile()); System.out.println(保存Excel到: excelFilePath); // 检查文件是否保存成功 if (!Files.exists(excelFilePath)) { throw new Exception(Excel文件保存失败); } // 检查LibreOffice LibreOfficeConverter converter new LibreOfficeConverter(sofficePath, timeout); boolean available converter.isAvailable(); System.out.println(LibreOffice可用性: available); if (!available) { throw new Exception(LibreOffice不可用请检查路径: sofficePath); } // 转换 String pdfFilePath converter.excelToPdf(excelFilePath.toString(), pdfPath.toString()); System.out.println(生成PDF: pdfFilePath); // 获取PDF文件名 Path pdfPathObj Paths.get(pdfFilePath); String pdfFileName pdfPathObj.getFileName().toString(); MapString, Object result new HashMap(); result.put(success, true); result.put(pdfPath, pdfFilePath); result.put(pdfName, pdfFileName); result.put(downloadUrl, /api/convert/download/ pdfFileName); return ResponseEntity.ok(result); } catch (Exception e) { e.printStackTrace(); MapString, Object error new HashMap(); error.put(success, false); error.put(message, e.getMessage()); error.put(type, e.getClass().getName()); return ResponseEntity.internalServerError().body(error); } finally { // 删除临时Excel文件 if (excelFilePath ! null Files.exists(excelFilePath)) { try { Files.deleteIfExists(excelFilePath); System.out.println(删除临时文件: excelFilePath); } catch (IOException e) { System.err.println(删除临时文件失败: e.getMessage()); } } } } }4.3 配置文件 (application.yml)yamllibreoffice: path: D:\\installsoft\\program\\soffice.exe timeout: 300 upload-dir: D:\\javaproject\\code\\regionprogect\\search\\uploads # 使用绝对路径 pdf-dir: D:\\javaproject\\code\\regionprogect\\search\\pdfs # 使用绝对路径五、关键参数详解参数作用--headless无图形界面模式不启动 UI--nofirststartwizard禁止首次运行向导弹窗--norestore不恢复上次崩溃未保存的文档--nologo不显示启动 Logo--invisible完全不可见模式配合 headless--convert-to pdf[:writer_pdf_Export]转换为 PDF可指定导出过滤器--outdir指定输出目录-env:UserInstallationfile:///path指定用户配置目录避免弹窗5.1 避免弹窗的额外技巧如果依然弹出“Press Enter to continue...”或配置向导可以添加-env:UserInstallation参数指定一个临时目录javaString tempUserDir System.getProperty(java.io.tmpdir) libreoffice_user_ System.currentTimeMillis(); String[] command { sofficePath, --headless, --nofirststartwizard, -env:UserInstallationfile:/// tempUserDir.replace(\\, /), --convert-to, pdf, --outdir, outputDir, excelPath }; // 转换完成后删除临时目录测试一下转换出来的pdf样式和之前的excel一样的如果是使用php的话也是支持的php实现的代码如下try { $sofficePath D:\installsoft\program\soffice.exe; // 构建命令 // 使用 :writer_pdf_Export 导出器确保 Excel 转 PDF 最佳效果 $command sprintf( %s --headless --convert-to pdf:writer_pdf_Export --outdir %s %s 21, escapeshellcmd($sofficePath), escapeshellarg($saveDir), escapeshellarg($filePath) ); $pdfName pathinfo($filePath, PATHINFO_FILENAME); Log::info(LibreOffice转换命令 . $command); // 设置环境变量解决中文乱码问题 putenv(LANGzh_CN.UTF-8); putenv(LANGUAGEzh_CN.UTF-8); // 执行转换 $output []; $returnCode 0; exec($command, $output, $returnCode); if ($returnCode ! 0) { $errorMsg implode(\n, $output); Log::error(LibreOffice转换失败 . $errorMsg); throw new \Exception(PDF转换失败 . $errorMsg); } if (!file_exists(app()-getRootPath() . public/storage/ .$savePath./.$filename..pdf)) { throw new \Exception(服务器繁忙请稍后再试); } // 返回成功结果 return [ code 200, msg 导出成功, data [ fileName $filename..pdf, fileUrl $savePath , ] ]; } catch (\Exception $e) { return [code 500, msg $e-getMessage()]; }六、异常处理与优化建议6.1 常见异常及解决方法异常现象可能原因解决方案进程超时文件过大或 LibreOffice 卡死增大 timeout 值或使用异步任务退出码非 0文件损坏、密码保护、路径含空格检查文件路径用双引号包裹弹出“User Installation”对话框首次运行缺少配置使用-env:UserInstallation参数中文文件名乱码系统编码问题设置LANGzh_CN.UTF-8环境变量6.2 性能优化复用用户配置目录指定固定的UserInstallation目录避免每次创建临时目录减少初始化开销。控制并发LibreOffice 进程启动较慢约 2-3 秒高并发时建议使用队列 单进程或连接池如 JodConverter 内置的进程池。异步处理对于大文件可改为异步转换 轮询结果避免 HTTP 请求阻塞。6.3 设置环境变量解决中文乱码javapb.environment().put(LANG, zh_CN.UTF-8); pb.environment().put(LANGUAGE, zh_CN.UTF-8);七、完整项目示例Maven 依赖不需要额外依赖仅使用 JDK 标准库。 Spring Boot 项目只需添加 Spring Web 起步依赖xmldependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency八、总结通过 Java 调用 LibreOffice 命令行我们可以低成本地获得企业级 Excel 转 PDF 功能样式保留度接近 100%。该方法不依赖昂贵的商业组件部署简单只需在服务器上安装 LibreOffice 即可。关键步骤回顾安装 LibreOffice记录可执行文件路径。使用ProcessBuilder执行带--headless等参数的转换命令。正确处理进程超时、输出目录、临时文件清理。利用-env:UserInstallation避免弹窗设置环境变量解决中文乱码。该方案已在多个生产环境中稳定运行支持 Excel、Word、PPT 转 PDF是开源技术栈中非常实用的文档转换方案。
spring boot 和php 调用 LibreOffice 转换 Excel 到 PDF 完整实现
发布时间：2026/6/8 14:58:05
在实际企业应用开发中经常需要将 Excel 报表、采购订单、入库单等文档转换为 PDF 格式以便于存档、打印或分发。相比直接操作 Excel 文件PDF 具有跨平台、防篡改、版面固定等优点。而 LibreOffice 作为一款开源的办公套件提供了强大的命令行转换能力能够高质量地保留 Excel 的复杂样式、图表、公式和排版是 Java 后端实现文档转换的理想选择。本文将详细介绍如何使用 Java 调用 LibreOffice 将 Excel 文件转换为 PDF并提供完整的代码示例、参数说明及常见问题解决方案。比如下面这种复杂excel表格转换pdf就恒麻烦尤其是样式回错乱。下面介绍一种方式来实现windows环境下的无损转换pdflinux只需要安装luinx下的包即可这里不做演示。一、为什么选择 LibreOffice目前主流的 Excel 转 PDF 方案有以下几种方案优点缺点Apache POI iText纯 Java无需安装额外软件样式还原度差对复杂表格、图表支持弱JodConverter封装了 LibreOffice 的调用API 友好同样需要安装 LibreOffice但依赖较重直接调用 LibreOffice 命令行样式保真度最高免费开源跨平台需要安装 LibreOffice依赖外部进程在企业级应用中样式保真度往往是最重要的指标。LibreOffice 能够完美呈现 Excel 中的字体、颜色、边框、合并单元格、公式计算结果、甚至嵌入式图表这是其他纯 Java 方案难以比拟的。因此推荐使用 Java 调用 LibreOffice 命令行的方式。二、环境准备2.1 安装 LibreOfficeWindows从 LibreOffice 官网 下载 LibreOffice | LibreOffice 简体中文官方网站 - 自由免费的办公套件下载安装包默认安装路径为C:\Program Files\LibreOffice\program\soffice.exeLinux (Ubuntu/Debian)sudo apt install libreoffice -yLinux (CentOS/RHEL)sudo yum install libreoffice -ymacOS通过 Homebrew 安装brew install --cask libreoffice安装后在终端执行soffice --version验证是否成功。2.2 Java 环境JDK 17及以上版本任何 Java 框架均可Spring Boot、普通 Maven 项目等三、核心原理LibreOffice 提供无界面headless模式可以通过命令行参数完成文档格式转换而不启动图形界面。Java 通过ProcessBuilder或Runtime.exec()调用系统命令执行 LibreOffice 的转换指令然后读取生成的 PDF 文件即可。基本命令格式如下bashsoffice --headless --convert-to pdf --outdir /output/dir /path/to/input.xlsx--headless无界面模式必需--convert-to pdf转换为 PDF--outdir输出目录最后为输入文件路径四、Java 实现步骤4.1 创建转换器类javapublic class LibreOfficeConverter { private static final Logger log LoggerFactory.getLogger(LibreOfficeConverter.class); private String sofficePath; private int timeoutSeconds; public LibreOfficeConverter(String sofficePath, int timeoutSeconds) { this.sofficePath sofficePath; this.timeoutSeconds timeoutSeconds; } public String excelToPdf(String excelPath, String outputDir) throws Exception { // ... 方法实现见之前的代码 File excelFile new File(excelPath); if (!excelFile.exists()) { throw new Exception(Excel文件不存在 excelPath); } File outputDirFile new File(outputDir); if (!outputDirFile.exists()) { outputDirFile.mkdirs(); } String absoluteExcelPath excelFile.getAbsolutePath(); String absoluteOutputDir outputDirFile.getAbsolutePath(); String command String.format( %s --headless --convert-to pdf:writer_pdf_Export --outdir %s %s, sofficePath, absoluteOutputDir, absoluteExcelPath ); log.info(LibreOffice转换命令{}, command); ProcessBuilder processBuilder new ProcessBuilder(); if (System.getProperty(os.name).toLowerCase().contains(windows)) { processBuilder.command(cmd.exe, /c, command); } else { processBuilder.command(bash, -c, command); } processBuilder.environment().put(LANG, zh_CN.UTF-8); processBuilder.environment().put(LANGUAGE, zh_CN.UTF-8); processBuilder.redirectErrorStream(true); Process process null; try { process processBuilder.start(); StringBuilder output new StringBuilder(); try (BufferedReader reader new BufferedReader( new InputStreamReader(process.getInputStream(), UTF-8))) { String line; while ((line reader.readLine()) ! null) { output.append(line).append(\n); } } boolean finished process.waitFor(timeoutSeconds, TimeUnit.SECONDS); if (!finished) { process.destroyForcibly(); throw new Exception(LibreOffice转换超时 timeoutSeconds 秒); } int exitCode process.exitValue(); if (exitCode ! 0) { throw new Exception(PDF转换失败退出码 exitCode); } String excelBaseName excelFile.getName(); int dotIndex excelBaseName.lastIndexOf(.); String pdfName (dotIndex 0 ? excelBaseName.substring(0, dotIndex) : excelBaseName) .pdf; String pdfPath absoluteOutputDir File.separator pdfName; return pdfPath; } finally { if (process ! null process.isAlive()) { process.destroyForcibly(); } } } public boolean isAvailable() { try { // 方法1直接检查文件是否存在 File sofficeFile new File(sofficePath); System.out.println(检查路径: sofficeFile.getAbsolutePath()); System.out.println(文件是否存在: sofficeFile.exists()); System.out.println(是否可读: sofficeFile.canRead()); System.out.println(是否可执行: sofficeFile.canExecute()); if (!sofficeFile.exists()) { // 尝试常见路径 String[] commonPaths { D:/installsoftware/program/soffice.exe, D:\\installsoftware\\program\\soffice.exe, }; for (String path : commonPaths) { File testFile new File(path); if (testFile.exists()) { sofficePath path; sofficeFile testFile; System.out.println(找到LibreOffice: path); break; } } if (!sofficeFile.exists()) { System.err.println(未找到LibreOffice可执行文件); return false; } } // 方法2直接执行命令使用 ProcessBuilder ProcessBuilder pb new ProcessBuilder( sofficeFile.getAbsolutePath(), --version ); pb.redirectErrorStream(true); Process process pb.start(); // 读取输出 StringBuilder output new StringBuilder(); try (BufferedReader reader new BufferedReader( new InputStreamReader(process.getInputStream(), UTF-8))) { String line; while ((line reader.readLine()) ! null) { output.append(line); } } boolean finished process.waitFor(5, TimeUnit.SECONDS); if (finished process.exitValue() 0) { System.out.println(LibreOffice版本: output.toString()); return true; } else { System.err.println(退出码: process.exitValue()); return false; } } catch (Exception e) { System.err.println(检查失败: e.getMessage()); e.printStackTrace(); return false; } } }javaRestController RequestMapping(/api/convert) public class ExcelToPdfController { Value(${libreoffice.path}) private String sofficePath; Value(${libreoffice.timeout:300}) private int timeout; Value(${file.upload-dir:./uploads}) private String uploadDir; Value(${file.pdf-dir:./pdfs}) private String pdfDir; /** * 上传Excel并转换为PDF */ PostMapping(/excel-to-pdf) public ResponseEntity? convertExcelToPdf(RequestParam(file) MultipartFile file) { Path excelFilePath null; try { // 使用绝对路径并规范化路径 Path uploadPath Paths.get(uploadDir).toAbsolutePath().normalize(); Path pdfPath Paths.get(pdfDir).toAbsolutePath().normalize(); // 打印调试信息 System.out.println(上传目录绝对路径: uploadPath); System.out.println(PDF目录绝对路径: pdfPath); // 创建目录 if (!Files.exists(uploadPath)) { Files.createDirectories(uploadPath); System.out.println(创建上传目录: uploadPath); } if (!Files.exists(pdfPath)) { Files.createDirectories(pdfPath); System.out.println(创建PDF目录: pdfPath); } // 保存上传的Excel文件 String originalFilename file.getOriginalFilename(); System.out.println(原始文件名: originalFilename); // 处理文件扩展名 String ext ; if (originalFilename ! null originalFilename.contains(.)) { ext originalFilename.substring(originalFilename.lastIndexOf(.)); } else { ext .xlsx; } String fileName UUID.randomUUID().toString() ext; excelFilePath uploadPath.resolve(fileName); // 确保父目录存在 Files.createDirectories(excelFilePath.getParent()); // 保存文件 file.transferTo(excelFilePath.toFile()); System.out.println(保存Excel到: excelFilePath); // 检查文件是否保存成功 if (!Files.exists(excelFilePath)) { throw new Exception(Excel文件保存失败); } // 检查LibreOffice LibreOfficeConverter converter new LibreOfficeConverter(sofficePath, timeout); boolean available converter.isAvailable(); System.out.println(LibreOffice可用性: available); if (!available) { throw new Exception(LibreOffice不可用请检查路径: sofficePath); } // 转换 String pdfFilePath converter.excelToPdf(excelFilePath.toString(), pdfPath.toString()); System.out.println(生成PDF: pdfFilePath); // 获取PDF文件名 Path pdfPathObj Paths.get(pdfFilePath); String pdfFileName pdfPathObj.getFileName().toString(); MapString, Object result new HashMap(); result.put(success, true); result.put(pdfPath, pdfFilePath); result.put(pdfName, pdfFileName); result.put(downloadUrl, /api/convert/download/ pdfFileName); return ResponseEntity.ok(result); } catch (Exception e) { e.printStackTrace(); MapString, Object error new HashMap(); error.put(success, false); error.put(message, e.getMessage()); error.put(type, e.getClass().getName()); return ResponseEntity.internalServerError().body(error); } finally { // 删除临时Excel文件 if (excelFilePath ! null Files.exists(excelFilePath)) { try { Files.deleteIfExists(excelFilePath); System.out.println(删除临时文件: excelFilePath); } catch (IOException e) { System.err.println(删除临时文件失败: e.getMessage()); } } } } }4.3 配置文件 (application.yml)yamllibreoffice: path: D:\\installsoft\\program\\soffice.exe timeout: 300 upload-dir: D:\\javaproject\\code\\regionprogect\\search\\uploads # 使用绝对路径 pdf-dir: D:\\javaproject\\code\\regionprogect\\search\\pdfs # 使用绝对路径五、关键参数详解参数作用--headless无图形界面模式不启动 UI--nofirststartwizard禁止首次运行向导弹窗--norestore不恢复上次崩溃未保存的文档--nologo不显示启动 Logo--invisible完全不可见模式配合 headless--convert-to pdf[:writer_pdf_Export]转换为 PDF可指定导出过滤器--outdir指定输出目录-env:UserInstallationfile:///path指定用户配置目录避免弹窗5.1 避免弹窗的额外技巧如果依然弹出“Press Enter to continue...”或配置向导可以添加-env:UserInstallation参数指定一个临时目录javaString tempUserDir System.getProperty(java.io.tmpdir) libreoffice_user_ System.currentTimeMillis(); String[] command { sofficePath, --headless, --nofirststartwizard, -env:UserInstallationfile:/// tempUserDir.replace(\\, /), --convert-to, pdf, --outdir, outputDir, excelPath }; // 转换完成后删除临时目录测试一下转换出来的pdf样式和之前的excel一样的如果是使用php的话也是支持的php实现的代码如下try { $sofficePath D:\installsoft\program\soffice.exe; // 构建命令 // 使用 :writer_pdf_Export 导出器确保 Excel 转 PDF 最佳效果 $command sprintf( %s --headless --convert-to pdf:writer_pdf_Export --outdir %s %s 21, escapeshellcmd($sofficePath), escapeshellarg($saveDir), escapeshellarg($filePath) ); $pdfName pathinfo($filePath, PATHINFO_FILENAME); Log::info(LibreOffice转换命令 . $command); // 设置环境变量解决中文乱码问题 putenv(LANGzh_CN.UTF-8); putenv(LANGUAGEzh_CN.UTF-8); // 执行转换 $output []; $returnCode 0; exec($command, $output, $returnCode); if ($returnCode ! 0) { $errorMsg implode(\n, $output); Log::error(LibreOffice转换失败 . $errorMsg); throw new \Exception(PDF转换失败 . $errorMsg); } if (!file_exists(app()-getRootPath() . public/storage/ .$savePath./.$filename..pdf)) { throw new \Exception(服务器繁忙请稍后再试); } // 返回成功结果 return [ code 200, msg 导出成功, data [ fileName $filename..pdf, fileUrl $savePath , ] ]; } catch (\Exception $e) { return [code 500, msg $e-getMessage()]; }六、异常处理与优化建议6.1 常见异常及解决方法异常现象可能原因解决方案进程超时文件过大或 LibreOffice 卡死增大 timeout 值或使用异步任务退出码非 0文件损坏、密码保护、路径含空格检查文件路径用双引号包裹弹出“User Installation”对话框首次运行缺少配置使用-env:UserInstallation参数中文文件名乱码系统编码问题设置LANGzh_CN.UTF-8环境变量6.2 性能优化复用用户配置目录指定固定的UserInstallation目录避免每次创建临时目录减少初始化开销。控制并发LibreOffice 进程启动较慢约 2-3 秒高并发时建议使用队列 单进程或连接池如 JodConverter 内置的进程池。异步处理对于大文件可改为异步转换 轮询结果避免 HTTP 请求阻塞。6.3 设置环境变量解决中文乱码javapb.environment().put(LANG, zh_CN.UTF-8); pb.environment().put(LANGUAGE, zh_CN.UTF-8);七、完整项目示例Maven 依赖不需要额外依赖仅使用 JDK 标准库。 Spring Boot 项目只需添加 Spring Web 起步依赖xmldependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency八、总结通过 Java 调用 LibreOffice 命令行我们可以低成本地获得企业级 Excel 转 PDF 功能样式保留度接近 100%。该方法不依赖昂贵的商业组件部署简单只需在服务器上安装 LibreOffice 即可。关键步骤回顾安装 LibreOffice记录可执行文件路径。使用ProcessBuilder执行带--headless等参数的转换命令。正确处理进程超时、输出目录、临时文件清理。利用-env:UserInstallation避免弹窗设置环境变量解决中文乱码。该方案已在多个生产环境中稳定运行支持 Excel、Word、PPT 转 PDF是开源技术栈中非常实用的文档转换方案。
相关文章
HCS12微控制器轻量级UDP/IP协议栈实现与优化指南
1. 项目概述：为什么要在HCS12上实现UDP/IP栈？ 在嵌入式开发领域，尤其是工业控制、传感器网络和远程监控这些场景，让一个“小”设备接入互联网，常常是项目成败的关键。但一提到网络协议栈，很多工程师的第一反…
HarmonyOS ArkUI 动画完全指南：属性动画、显式动画与组件动画
文章目录 前言一、属性动画：.animation()1.1 最简单的动画写法1.2 常用缓动曲线 二、显式动画：animateTo()2.1 animateTo 与 .animation() 的区别 三、MapKit ScaleAnimation：项目核心动画3.1 源码分析3.2 ScaleAnimation 参数详解 四、转场动…
HarmonyOS ArkUI 弹性布局：Row 与 Column 深度解析
文章目录前言一、主轴与交叉轴1.1 概念理解1.2 justifyContent 所有值1.3 本项目中的 justifyContent 用法二、alignItems：交叉轴对齐2.1 Column 中的 HorizontalAlign2.2 Row 中的 VerticalAlign三、layoutWeight：按比例分配空间3.1 什么是 layoutWeigh…
TEKLauncher：如何用3个核心功能解决《方舟：生存进化》的MOD管理难题？
TEKLauncher：如何用3个核心功能解决《方舟：生存进化》的MOD管理难题？ 【免费下载链接】TEKLauncher Launcher for ARK: Survival Evolved 项目地址: https://gitcode.com/gh_mirrors/te/TEKLauncher TEKLauncher是一款专为《方舟&…
如何轻松掌握Windows窗口强制调整：WindowResizer完整实战指南
如何轻松掌握Windows窗口强制调整：WindowResizer完整实战指南 【免费下载链接】WindowResizer 一个可以强制调整应用程序窗口大小的工具 项目地址: https://gitcode.com/gh_mirrors/wi/WindowResizer 你是否曾遇到那些固执的应用程序窗口，无论如何…
计算机毕业设计之基于 Python 的仓库管理系统设计与实现
信息技术是当今社会发展的重要方向之一，它已经深入到各个行业中。随着计算机技术的发展，信息技术已经从传统的数据处理转变为网络信息的处理和交互。在管理方面，通过信息管理技术，系统可以快速的处理大量的数据，并且能…
Windows下免安装的耳机插拔实时监听工具（C++源码+编译好的exe）
本文还有配套的精品资源，点击获取 简介：这个工具能在Windows系统上实时捕获耳机接口的插入和拔出动作，不依赖第三方库，双击HeadphoneChange.exe就能运行。程序基于Windows Core Audio API实现，启动后自动注册音频端…
DSP56300通过ECP并口与PC实现高速数据通信的软硬件方案
1. 项目概述：为什么选择ECP连接DSP与PC？在嵌入式信号处理系统的开发中，尤其是在那些需要与PC进行频繁、高速数据交换的场景里——比如实时音频处理、图像采集分析或者工业控制——通信接口的选择往往是决定系统性能上限的关键。早年ÿ…
基于LPC55S69与Mosquitto的嵌入式物联网TLS安全连接实践
1. 项目概述在物联网项目里，设备与云端的数据通道，就像是家里的水管。水管本身如果材质不好、接口不严，不仅可能漏水（数据丢失），更可怕的是别人能轻易往里投毒或者偷水（数据窃取与篡改ÿ…
解决老旧机顶盒资源化难题：Amlogic S9xxx Armbian项目在TY1608设备上的系统适配实现
解决老旧机顶盒资源化难题：Amlogic S9xxx Armbian项目在TY1608设备上的系统适配实现 【免费下载链接】amlogic-s9xxx-armbian Supports running Armbian on Amlogic, Allwinner, and Rockchip devices. Support a311d, s922x, s905x3, s905x2, s912, s905d, s905x, …
Python Scrapy 爬虫实战进阶系列（一）：轻量化数据存储 - 数据精准写入 SQLite 数据库
前言 在 Python 爬虫开发领域中，Scrapy 作为高性能、高可扩展性的异步爬虫框架，是行业内采集结构化数据的首选工具。在中小型爬虫项目、本地数据采集、轻量化数据存储场景中，SQLite 无需独立服务、单文件存储、原生兼容 Python 的特性&#…
3步实现Windows直读Btrfs分区：跨平台文件系统互通终极方案
3步实现Windows直读Btrfs分区：跨平台文件系统互通终极方案 【免费下载链接】btrfs WinBtrfs - an open-source btrfs driver for Windows 项目地址: https://gitcode.com/gh_mirrors/bt/btrfs 还在为Windows无法访问Linux Btrfs分区而烦恼吗？你是…
LED驱动技术全解析：从核心架构到实战选型与避坑指南
1. 从一颗灯珠到千亿市场：LED驱动的技术演进与商业逻辑十几年前，当我第一次从料盘上拿起一颗0603封装的白色LED时，它微弱的光晕和高达几块钱的单颗成本，让我很难想象今天它几乎照亮了我们生活的每一个角落。从手机屏幕的一抹背光&…
索引堆及其优化
索引堆及其优化 引言 索引堆是一种数据结构，广泛应用于计算机科学和软件工程领域。它主要用于解决优先队列问题，如最小堆和最大堆。本文将详细介绍索引堆的概念、实现方法以及优化策略。 索引堆的定义 索引堆是一种基于堆数据结构的索引机制。它通过维护一个堆来存储数据…
从零到日增237精准粉丝，我靠CSDN这张AI卡片爆了！手把手复刻全流程，含配置避坑清单
更多请点击： https://intelliparadigm.com 第一章：CSDN AI 数字营销的官方引流卡片是什么功能？ CSDN AI 数字营销平台推出的「官方引流卡片」，是一种面向技术创作者的轻量级、可嵌入式内容分发组件，专为提升博文、教程…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…