如何在LibreOffice中调试Java UNO组件？

我完全懂这种排查无反馈的痛苦——静默终止连个异常提示都没有，逐行调试简直是折磨！针对你开发LibreOffice UNO组件时遇到的问题，这里有几个实用方案来开启异常追踪、找到Java控制台输出：

1. 用命令行参数启动LibreOffice #

直接通过终端/命令提示符启动LO时，加上调试相关参数，就能强制输出详细的异常信息：

# Linux/macOS
soffice --accept="socket,host=localhost,port=2002;urp;" --norestore --nodefault --nofirststartwizard --debuglevel=2

# Windows（替换为你的LO安装路径）
"C:\Program Files\LibreOffice\program\soffice.exe" --accept="socket,host=localhost,port=2002;urp;" --norestore --nodefault --nofirststartwizard --debuglevel=2

其中--debuglevel=2会开启最高级别的调试日志，包括未捕获的异常堆栈信息，能帮你直接定位到类缺失的问题。

2. 配置JVM调试参数 #

LO的Java组件运行在JVM上，你可以给JVM添加参数强制输出所有异常：

1. 打开LibreOffice，依次点击「工具」→「选项」→「LibreOffice」→「高级」
2. 在「Java选项」输入框中添加：

   -Djava.util.logging.config.file=./logging.properties
   

3. 创建一个logging.properties文件（放在LO启动目录或者你的组件目录），内容如下：

   handlers= java.util.logging.ConsoleHandler
   .level= INFO
   java.util.logging.ConsoleHandler.level= FINEST
   java.util.logging.ConsoleHandler.formatter= java.util.logging.SimpleFormatter
   

   这样JVM会把所有详细日志（包括异常堆栈）输出到Java控制台。

1. Windows系统 #

• Java控制台：打开Windows控制面板→「Java」→「高级」→「控制台」，选择「显示控制台」，之后启动LO时会自动弹出Java控制台，所有Java相关输出都会在这里显示。
• LO日志文件：默认存放在%APPDATA%\LibreOffice\<版本号>\user\log（比如C:\Users\你的用户名\AppData\Roaming\LibreOffice\7\user\log），里面会记录LO运行的详细日志，包括组件加载失败的信息。

2. Linux/macOS系统 #

• Java控制台：如果从终端启动LO，Java的输出会直接打印在终端窗口里；如果是图形界面启动，可以通过journalctl（Linux）查看系统日志中的LO相关条目，或者在启动脚本中添加输出重定向。
• LO日志文件：存放在~/.config/libreoffice/<版本号>/user/log目录下，比如~/.config/libreoffice/7.5/user/log。

• 如果用NetBeans/Eclipse开发UNO组件，可以直接把LO作为调试目标附加到IDE，这样能在代码中设置断点，直接捕获到类加载失败的异常，比看控制台效率高得多。
• 打包oxt包时，务必检查：所需的jar文件是否放在oxt的lib目录下，且META-INF/manifest.xml中是否正确声明了类路径（比如Class-Path: lib/your-dependency.jar）。

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