解决SpringBoot启动jPOS Q2服务时Port value not set错误

在SpringBoot项目中启动jPOS Q2服务时，控制台抛出org.jpos.core.ConfigurationException: Port value not set错误，相关日志及启动代码如下：

控制台日志 #

<log realm="xml-server-8000" at="2022-10-06T11:53:39.958559400">  
 <warn>
     error starting service
     <iso-exception>
       Port value not set
       org.jpos.core.ConfigurationException: Port value not set     at org.jpos.q2.iso.QServer.initServer(QServer.java:92)  at
 org.jpos.q2.iso.QServer.startService(QServer.java:155)     at
 org.jpos.q2.QBeanSupport.start(QBeanSupport.java:118)  at
 java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native
 Method)    at
 java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at
 java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)   at
 sun.reflect.misc.Trampoline.invoke(MethodUtil.java:72)     at
 java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native
 Method)    at
 java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
    at
 java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:568)   at
 java.base/sun.reflect.misc.MethodUtil.invoke(MethodUtil.java:262)  at
 java.management/com.sun.jmx.mbeanserver.StandardMBeanIntrospector.invokeM2(StandardMBeanIntrospector.java:112)
    at
 java.management/com.sun.jmx.mbeanserver.StandardMBeanIntrospector.invokeM2(StandardMBeanIntrospector.java:46)
    at
 java.management/com.sun.jmx.mbeanserver.MBeanIntrospector.invokeM(MBeanIntrospector.java:237)
    at
 java.management/com.sun.jmx.mbeanserver.PerInterface.invoke(PerInterface.java:138)
    at
 java.management/com.sun.jmx.mbeanserver.MBeanSupport.invoke(MBeanSupport.java:252)
    at
 java.management/com.sun.jmx.interceptor.DefaultMBeanServerInterceptor.invoke(DefaultMBeanServerInterceptor.java:814)
    at
 java.management/com.sun.jmx.mbeanserver.JmxMBeanServer.invoke(JmxMBeanServer.java:802)
    at org.jpos.q2.QFactory.startQBean(QFactory.java:187)   at
 org.jpos.q2.Q2.start(Q2.java:576)  at
 org.jpos.q2.Q2.deploy(Q2.java:360)     at org.jpos.q2.Q2.run(Q2.java:220)
    at java.base/java.lang.Thread.run(Thread.java:833)
     </iso-exception>   </warn> </log> <log realm="Q2.system" at="2022-10-06T11:53:42.751307300" lifespan="286ms">

启动代码 #

@SpringBootApplication public class JposApplication implements CommandLineRunner {
    public static void main(String[] args) {
        SpringApplication.run(JposApplication.class, args);
    }

    @Override
    public void run(String...args) 
    {
        Q2 q2 =new Q2();
        q2.start();
    }
}

该错误核心是jPOS的QServer服务缺少端口配置，Q2启动时会自动加载deploy目录下的XML部署描述文件，其中的QServer实例未正确设置端口参数，修复步骤如下：

• 检查并补充QServer配置文件
  找到项目中src/main/resources/deploy（或jPOS默认的deploy路径）下的QServer配置文件（如日志中的xml-server-8000.xml），确保文件内包含端口配置项。示例正确配置：

  <server name="xml-server-8000" class="org.jpos.q2.iso.QServer" logger="Q2">
      <attr name="port" type="java.lang.Integer">8000</attr>
      <channel class="org.jpos.iso.channel.XMLChannel"
               packager="org.jpos.iso.packager.XMLPackager">
          <!-- 通道其他配置 -->
      </channel>
  </server>
  

  端口可通过<attr>或<property>标签定义，确保值为有效整数端口号，避免拼写错误。

• 指定自定义deploy路径（若需）
  若项目的deploy目录不在jPOS默认位置，初始化Q2时需显式指定路径：

  @Override
  public void run(String...args) 
  {
      Q2 q2 = new Q2("your/custom/deploy/path");
      q2.start();
  }
  

• 验证端口有效性
  启动前确认配置的端口未被占用，且配置格式符合jPOS要求。

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