Tomcat部署的Spring Boot WAR包无法与本地C程序建立Socket连接

按优先级从高到低排查： #

• 先确认Socket连接代码里的目标地址不要写localhost，直接硬编码指定127.0.0.1
  绝大多数这类场景的不通都是localhost解析歧义导致的：IDE运行时JVM默认把localhost解析为IPv4的127.0.0.1，独立Tomcat的JVM可能优先解析为IPv6的::1，如果你的C程序只监听了IPv4环回地址，就会直接抛连接拒绝。如果要一劳永逸解决解析问题，可以在Tomcat启动脚本里的JAVA_OPTS变量中添加参数-Djava.net.preferIPv4Stack=true，强制JVM使用IPv4栈。
• 核对WAR包的Spring Boot启动配置是否符合外部容器部署要求
  IDE中直接运行是走内嵌Tomcat加载逻辑，如果你把Socket客户端初始化逻辑写在启动流程里，打WAR包时必须让启动类继承SpringBootServletInitializer并重写configure方法，否则部署到外部Tomcat时相关Bean根本不会被实例化，或者初始化时机异常。正确启动类示例：

  @SpringBootApplication
  public class Application extends SpringBootServletInitializer {
      @Override
      protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
          return builder.sources(Application.class);
      }
      public static void main(String[] args) {
          SpringApplication.run(Application.class, args);
      }
  }
  

  同时检查Maven/Gradle配置，必须把内嵌Tomcat依赖的scope设为provided，避免和外部Tomcat的类库冲突导致网络类加载异常，Maven配置参考：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-tomcat</artifactId>
      <scope>provided</scope>
  </dependency>
  

• 查全Tomcat的所有日志，不要只看应用自身日志
  外部Tomcat会把应用启动时抛出的部分异常吞到容器自身日志里，直接去Tomcat根目录下的logs文件夹，依次排查catalina.out、localhost.日期.log、应用对应的日志文件，搜索ConnectException、SocketTimeoutException、AccessControlException、NoClassDefFoundError关键词，90%的场景能直接找到根因。
• 排查进程权限与防火墙拦截问题
  如果独立Tomcat是作为系统服务运行（Windows服务、Linux下systemd管理的Tomcat），默认会用低权限专用账户启动（比如Linux下的tomcat用户、Windows下的Local Service账户），和你开IDE用的当前登录用户权限不一样，可能被本地防火墙、终端安全软件拦截出站连接。可以临时把Tomcat服务的启动账户改成你当前登录的本地用户，重启服务后测试连通性，快速定位是不是权限拦截问题。
• 加临时测试接口拿真实报错
  不要只靠启动时的自动连接逻辑排查，可以临时在Controller里加一个测试接口，部署后手动调用触发Socket连接，把完整异常栈打印出来，避免异常被上层逻辑吞掉看不到真实原因：

  @GetMapping("/socket-test")
  public String testSocketConn() throws IOException {
      try (Socket socket = new Socket()) {
          socket.connect(new InetSocketAddress("127.0.0.1", 你的C服务监听端口), 3000);
          return "Socket连接成功";
      } catch (Exception e) {
          StringWriter sw = new StringWriter();
          e.printStackTrace(new PrintWriter(sw));
          return "连接失败，异常栈：\n" + sw;
      }
  }
  

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