传递Jar参数时触发com.beust.jcommander.ParameterException异常：传入主参数'desc'但未定义主参数

异常成因 #

这个com.beust.jcommander.ParameterException异常的核心原因是JCommander默认以空格作为参数的分隔符。当你传入--order-by serialnumber, to_timestamp(startdate) desc时，它会把这个参数拆分成三个独立的部分：

• serialnumber,
• to_timestamp(startdate)
• desc

而你的JCommander配置里只定义了--order-by这个选项参数，并没有定义名为desc的主参数（也就是无对应配置的位置参数），所以系统会报错说"传入了主参数'desc'但未定义任何主参数"。

解决办法 #

这里有两种可靠的解决方式：

1. 用引号包裹完整的排序表达式

在命令行中，把--order-by后面的整个排序规则用双引号（或单引号）包裹起来，让JCommander把引号内的内容当作一个完整的参数值，而不是拆分成多个部分。示例命令如下：

java -jar your-app.jar --order-by "serialnumber, to_timestamp(startdate) desc"

注：Windows命令行优先用双引号，类Unix系统（Linux/macOS）单双引号均可正常工作。

2. 确保参数配置正确接收字符串值

检查你的代码中对应--order-by的参数定义，确保它是一个可以接收完整字符串的字段。比如使用@Parameter注解时，对应的字段类型应该是String，示例代码片段：

import com.beust.jcommander.Parameter;

public class YourCommandOptions {
    @Parameter(names = "--order-by", description = "Sort order expression")
    private String orderBy;

    // 其他参数定义...
}

这样当你用引号传递完整表达式后，orderBy字段会拿到整个serialnumber, to_timestamp(startdate) desc字符串，之后你可以在代码里自行解析这个排序规则。

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