SpringBoot整合第三方支付时读取资源文件遇NullPointerException求助

在SpringBoot电商项目整合第三方支付网关时，触发如下空指针异常：

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.NullPointerException: Cannot invoke "java.net.URL.toString()" because "fileURL" is null]

已尝试将EcpayPayment.xml移至resources目录，并修改PaymentVerifyBase.java中的confPath为./src/main/resources/EcpayPayment.xml或/EcpayPayment.xml，但fileURL始终为null，错误持续存在。相关代码如下：

package ecpay.payment.integration.ecpayOperator;

import ecpay.payment.integration.errorMsg.ErrorMessage;
import ecpay.payment.integration.exception.EcpayException;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;

import java.net.URL;
import java.util.ArrayList;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class PaymentVerifyBase{
    protected String confPath = "./src/main/resources/EcpayPayment.xml"; // 修改后的路径
    protected Document doc;
    public PaymentVerifyBase(){
        URL fileURL = this.getClass().getResource(confPath);
        doc = EcpayFunction.xmlParser(fileURL.toString()); // 此处触发空指针
        doc.getDocumentElement().normalize();
    }
    
    // 以下为其他方法省略...
}

1. 确认文件的实际位置 #

SpringBoot打包后，resources目录下的文件会被放到classpath根目录。先检查target/classes目录（开发环境）或打包后的jar包内，确认EcpayPayment.xml是否存在。如果不存在，检查pom.xml的resources配置，确保xml文件被正确复制到classpath：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>

2. 修正资源读取路径 #

开发时的./src/main/resources/路径在打包后不存在，必须使用classpath路径读取：

• 使用类加载器读取（最可靠）：

  URL fileURL = this.getClass().getClassLoader().getResource("EcpayPayment.xml");
  

• 或者使用类的getResource方法，注意路径开头加斜杠表示classpath根目录：

  URL fileURL = this.getClass().getResource("/EcpayPayment.xml");
  

3. 增加空值判断 #

在调用toString()前先校验fileURL，抛出明确异常便于排查：

public PaymentVerifyBase(){
    URL fileURL = this.getClass().getClassLoader().getResource("EcpayPayment.xml");
    if (fileURL == null) {
        throw new EcpayException("配置文件EcpayPayment.xml未找到，请确认文件放置在resources目录下");
    }
    doc = EcpayFunction.xmlParser(fileURL.toString());
    doc.getDocumentElement().normalize();
}

4. Spring环境下推荐的读取方式 #

利用Spring的ResourceLoader注入读取资源，更符合SpringBoot规范：

import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.beans.factory.annotation.Autowired;
import javax.annotation.PostConstruct;

public class PaymentVerifyBase{
    protected Document doc;
    
    @Autowired
    private ResourceLoader resourceLoader;

    @PostConstruct
    public void init() throws Exception {
        Resource resource = resourceLoader.getResource("classpath:EcpayPayment.xml");
        doc = EcpayFunction.xmlParser(resource.getURL().toString());
        doc.getDocumentElement().normalize();
    }
    
    // 以下为其他方法省略...
}

注：不能在构造函数中直接使用ResourceLoader，需用@PostConstruct注解的方法完成初始化，此时Spring已完成依赖注入。

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