pdf生成排查记录与解决方案
第一次出错：ClassNotFound异常
错误信息
Handler dispatch failed; nested exception is java.lang.NoClassDefFoundError: org/springframework/http/client/ClientHttpRequestFactory排查步骤
1. 验证类路径是否存在
packagecom.tgerp.workaffairs.service.impl;publicclassClassPathTest{publicstaticvoidmain(String[]args){try{Class<?>clazz=Class.forName("org.springframework.http.client.ClientHttpRequestFactory");System.out.println("Class found: "+clazz);}catch(ClassNotFoundExceptione){System.out.println("Class not found in classpath");}}}结果：类存在，排除基础依赖缺失。
2. 依赖分析
- 问题：
spring-web依赖缺失或版本不匹配 - 检查方法：
- IDEA依赖分析工具
- Maven依赖树检查
3. 解决方案
Maven项目：
<!-- 非Spring Boot项目 --><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>与你的Spring核心版本一致</version></dependency><!-- Spring Boot项目 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>Gradle项目：
implementation'org.springframework:spring-web:版本号'// 或Spring Boot项目implementation'org.springframework.boot:spring-boot-starter-web'4. 依赖冲突排查
# Maven项目mvn dependency:tree# Gradle项目gradle dependencies5. 构建清理
# Mavenmvn cleaninstall# Gradle./gradlew clean build# IDE缓存清理# IntelliJ: File → Invalidate Caches and Restart# Eclipse: Project → Clean6. 依赖完整性检查
# Linux/Macfind.-name"*.jar"|xargsgrep-l"ClientHttpRequestFactory"# Windows PowerShellGet-ChildItem -Recurse -Filter"*.jar"|ForEach-Object{if(Select-String -Path$_.FullName -Pattern"ClientHttpRequestFactory"-Quiet){$_.FullName}}第二次出错：连接被拒绝
错误信息
org.springframework.web.client.ResourceAccessException: I/O error on POST request for "https://xxxxxx:8443/xxxx": Connection refused: connect; nested exception is java.net.ConnectException: Connection refused: connectHTTP/HTTPS连接过程
发起连接：当你的浏览器（或任何客户端程序）想要访问 http://www.example.com 时，它知道需要连接服务器的 80 端口（HTTP默认端口）或 443 端口（HTTPS默认端口）。
请求操作系统：应用程序向操作系统发起一个网络连接请求（例如，调用 socket() 和 connect() 系统调用）。
操作系统分配端口：你的操作系统会从它的 “本地临时端口范围” 中，挑选一个当前未被使用的端口。
在Linux/Unix/Windows系统中，这个范围通常是 1024 到 65535。
端口 0-1023 被称为“知名端口”，通常需要管理员权限才能绑定，用于HTTP、FTP、SSH等标准服务。
建立连接：操作系统将这个随机选择的端口（例如 54321）作为 源端口，将目标服务器的IP地址和端口（例如 93.184.216.34:80）作为 目标地址，发起TCP三次握手。
端口绑定：一旦连接建立，这个 本地IP:54321 到 服务器IP:80 的“套接字”组合在整个通信会话期间（直到你关闭网页）都会保持不变。
通信过程如下：
• 你的请求包：[源IP:你的IP, 源端口:54321] -> [目标IP:服务器IP, 目标端口:80]
• 服务器的响应包：[源IP:服务器IP, 源端口:80] -> [目标IP:你的IP, 目标端口:54321]
排查步骤
1. 网络连通性检查
# 检查TCP连接（替换实际地址）telnet xxxxxx8443# 或nc-zv xxxxxx8443# Windows PowerShellTest-NetConnection xxxxxx -Port84432. 防火墙检查
# Linux检查防火墙sudoiptables -Lsudofirewall-cmd --list-all# Windows检查防火墙netsh advfirewall show allprofiles3. SSL证书验证
// 临时绕过SSL验证（仅用于测试，生产环境不推荐）@ConfigurationpublicclassSSLConfig{@PostConstructpublicvoiddisableSSLValidation()throwsException{// 仅用于测试环境TrustManager[]trustAllCerts=newTrustManager[]{newX509TrustManager(){publicX509Certificate[]getAcceptedIssuers(){returnnull;}publicvoidcheckClientTrusted(X509Certificate[]certs,StringauthType){}publicvoidcheckServerTrusted(X509Certificate[]certs,StringauthType){}}};SSLContextsc=SSLContext.getInstance("SSL");sc.init(null,trustAllCerts,newSecureRandom());HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());}}4. 连接超时设置
@ConfigurationpublicclassRestTemplateConfig{@BeanpublicRestTemplaterestTemplate(){SimpleClientHttpRequestFactoryfactory=newSimpleClientHttpRequestFactory();factory.setConnectTimeout(5000);// 5秒连接超时factory.setReadTimeout(10000);// 10秒读取超时returnnewRestTemplate(factory);}}根本原因
端口访问权限问题：应用程序所在服务器无法访问目标服务器的8443端口。
白名单问题：应用程序所在服务器未加入到对方的白名单。
解决方案
- 联系网络管理员，开通服务器之间的端口访问权限
- 检查目标服务是否正常运行在8443端口
- 验证网络策略和防火墙规则
第三次出错：文件路径格式错误
错误信息
java.io.FileNotFoundException: file:\\D:\\Program%20Files\\tgerp-cloud-server\\tgerp-modules-workaffairs.jar!\\BOOT-INF\\classes!\\template\\stamp.svg (文件名、目录名或卷标语法不正确。)问题分析
错误路径格式：
file:\\D:\\Program%20Files\\tgerp-cloud-server\\tgerp-modules-workaffairs.jar!\\BOOT-INF\\classes!\\template\\stamp.svg问题：
- 双重"!"分隔符：
jar!\\BOOT-INF\\classes!\\template\\stamp.svg不正确 - URL编码问题：
%20未正确解码为空格 - 协议格式错误：应该是
jar:file:///格式
正确路径格式
jar:file:///D:/Program%20Files/tgerp-cloud-server/tgerp-modules-workaffairs.jar!/BOOT-INF/classes/template/stamp.svg解决方案
方案1：使用ClassPathResource（推荐）
importorg.springframework.core.io.ClassPathResource;importorg.springframework.core.io.Resource;importjava.io.InputStream;// 读取JAR包内的资源Resourceresource=newClassPathResource("template/stamp.svg");InputStreaminputStream=resource.getInputStream();// 如果不在类路径根目录，使用相对路径Resourceresource2=newClassPathResource("static/template/stamp.svg");方案2：使用类加载器
// 获取资源流InputStreaminputStream=getClass().getClassLoader().getResourceAsStream("template/stamp.svg");// 获取资源URLURLresourceUrl=getClass().getClassLoader().getResource("template/stamp.svg");方案3：修复文件路径（如果必须使用文件系统路径）
importjava.net.URLDecoder;importjava.nio.charset.StandardCharsets;// 解码URL编码的路径StringdecodedPath=URLDecoder.decode("D:\\Program%20Files\\tgerp-cloud-server",StandardCharsets.UTF_8.name());// 使用正确的路径分隔符StringcorrectPath=decodedPath.replace("\\","/")+"/tgerp-modules-workaffairs.jar";// 构建正确的JAR URLStringjarUrl="jar:file:///"+correctPath+"!/BOOT-INF/classes/template/stamp.svg";方案4：Spring Boot资源加载最佳实践
importorg.springframework.beans.factory.annotation.Value;importorg.springframework.core.io.Resource;importorg.springframework.stereotype.Component;importjavax.annotation.PostConstruct;importjava.io.IOException;importjava.io.InputStream;@ComponentpublicclassResourceLoaderService{@Value("classpath:template/stamp.svg")privateResourcestampResource;@PostConstructpublicvoidloadResource()throwsIOException{try(InputStreamis=stampResource.getInputStream()){// 处理资源// ...}}// 或者使用ResourceLoader@AutowiredprivateResourceLoaderresourceLoader;publicvoidloadResourceDynamic(Stringpath)throwsIOException{Resourceresource=resourceLoader.getResource("classpath:"+path);// 使用资源...}}预防措施
- 统一资源加载方式：在Spring Boot项目中统一使用
ClassPathResource或ResourceLoader - 路径标准化：使用
Paths.get()和toUri()方法处理路径 - 编码处理：始终对路径进行URL编码/解码处理
- 错误处理：添加适当的异常处理机制
publicclassResourceUtils{publicstaticInputStreamloadResource(Stringclasspath)throwsIOException{Resourceresource=newClassPathResource(classpath);if(!resource.exists()){thrownewFileNotFoundException("Resource not found: "+classpath);}returnresource.getInputStream();}publicstaticStringgetResourcePath(Stringclasspath){try{URLurl=ResourceUtils.class.getClassLoader().getResource(classpath);returnurl!=null?url.getPath():null;}catch(Exceptione){returnnull;}}}总结
| 问题 | 原因 | 解决方案 |
|---|---|---|
| NoClassDefFoundError | 依赖缺失或版本冲突 | 添加正确依赖，检查依赖树 |
| Connection refused | 网络连接问题 | 检查网络、防火墙、端口访问权限 |
| FileNotFoundException | JAR内资源路径格式错误 | 使用ClassPathResource或类加载器读取资源 |
最佳实践建议：
- 使用Maven/Gradle依赖管理，避免版本冲突
- 网络连接配置适当的超时和重试机制
- 资源加载统一使用Spring的Resource API
- 完善的异常处理和日志记录
输出为C#代码)
