Android Volley空指针异常求助：原因解析及解决方案

Hey there, let’s break down this Volley crash and get it fixed for you!

为什么会出现这个错误？ #

从你的报错日志里能清晰定位问题：

E/Volley: [3997] NetworkDispatcher.processRequest: Unhandled exception java.lang.NullPointerException: Attempt to invoke virtual method 'int java.lang.String.length()' on a null object reference

这个空指针是在URLEncoder.encode()方法里触发的——Volley的Request.encodeParameters()会对请求参数做URL编码，如果你的请求参数Map里存在值为null的键值对，URLEncoder在编码时会尝试调用这个null字符串的length()方法，直接导致崩溃。

举个典型的错误场景：你可能在构建请求参数时，不小心把一个null值塞进去了，比如：

HashMap<String, String> params = new HashMap<>();
params.put("email", userEmail); // userEmail此时为null
StringRequest request = new StringRequest(Method.POST, API_URL, successListener, errorListener) {
    @Override
    protected Map<String, String> getParams() {
        return params;
    }
};

怎么修复？ #

给你几个实用的解决方案，按需选择：

• 手动过滤null参数：在返回请求参数前，遍历参数Map，把值为null的键值对移除，或者替换成空字符串""。代码示例：

@Override
protected Map<String, String> getParams() {
    HashMap<String, String> params = new HashMap<>();
    params.put("username", userName);
    params.put("email", userEmail);
    
    // 清理null值
    Iterator<Map.Entry<String, String>> iterator = params.entrySet().iterator();
    while (iterator.hasNext()) {
        Map.Entry<String, String> entry = iterator.next();
        if (entry.getValue() == null) {
            iterator.remove(); // 直接移除这个参数
            // 或者替换为空字符串：entry.setValue("");
        }
    }
    return params;
}

• 自定义安全Request类：如果不想每次写请求都手动过滤，可以封装一个自定义Request，重写encodeParameters方法统一处理null值：

public class SafeStringRequest extends StringRequest {
    public SafeStringRequest(int method, String url, Response.Listener<String> listener, Response.ErrorListener errorListener) {
        super(method, url, listener, errorListener);
    }

    @Override
    protected byte[] encodeParameters(Map<String, String> params, String paramsEncoding) {
        // 先把所有null值替换成空字符串
        for (Map.Entry<String, String> entry : params.entrySet()) {
            if (entry.getValue() == null) {
                entry.setValue("");
            }
        }
        return super.encodeParameters(params, paramsEncoding);
    }
}

之后所有请求都用这个SafeStringRequest代替原生的StringRequest，一劳永逸。

• 提前确保参数非null：在设置参数值的时候就做非null判断，比如用Android自带的工具类（API 24+可用）：

import java.util.Objects;

// ...
params.put("email", Objects.requireNonNullElse(userEmail, ""));

如果需要兼容更低版本，自己写个简单的工具方法就行：

private String nullToEmpty(String str) {
    return str == null ? "" : str;
}

// 使用
params.put("email", nullToEmpty(userEmail));

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