The server encountered an internal error that prevented it from fulfilling this request的一种解决办法[通俗易懂]

大家好，又见面了，我是你们的朋友全栈君。

一个异常引起的乌龙，HTTPStatus500问题的一种场景及解决办法

一、前言

    这是我在编写服务器响应判断用户数据时遇到的问题，这只是   The server encountered an internal error that prevented it from fulfilling this request  问题的一种情况，具体错误如下图所示：

二、问题描述

    我在设置某一属性  grade  时，设置为  int<11>  。在测试数据时，表单提交数据超出原设定范围，所引起的异常。

2-1 问题解决的方法

    对异常捕获，仅仅捕获了 SQLException，导致其他异常出现时，被抛出。

try{
    // ...
} catch(SQLException e) {
    e.printStackTrace();
}

捕获异常 Exception 即可

try{
    // ...
} catch(Exception e) {
    e.printStackTrace();
}

2-2 问题出现与解决

    在输入信息栏输入正确的信息，会给出正确的提示    

    处理后正确的响应结果如右图所示

三、问题解决

3-1 解决思路一

    其实问题的解决方法就是规范化开发，对填写信息的文本域填写的内容动态的监控，定义可输入的内容为数字，大小写英文，不允许输入特殊字符等控制。比如注册用户时填写用户 ID 时可通过 Ajax 动态获取后台数据，验证该 ID 是否已存在，若存在在注册页面则提示该 ID 已被注册

3-2 解决思路二

    此处我使用的是这个思路来避免该问题。当输入信息错误时，给出了不是我所写的错误处理办法，（我的错误处理办法是，给出提示：系统繁忙，稍后操作！）输入超出原定范围的数据。此处通过捕获抛出的异常进行处理，跳转到一个操作失败页面

    点击确定后出现的错误如下：

回去检查文件代码，多次修改，发现该问题的解决办法：

修改前的代码：     

修改后的代码：（红线已标出）

保存修改，重新运行程序，

输入错误的数据，给出了我所设定的处理方法：（下图所示）                          

    当出现异常时，认真检查代码的正确性，或许就是一个字符，单词的大小写或拼写错误，都够你调试一下午的。养成良好的代码风格，也是必须的。

四、其他异常补充

4.1 空指针异常(NullPointerException 先看一下)

HTTP Status 500 - Request processing failed; nested exception is 
java.lang.NullPointerException
com.dorm.action.CounsellorAction.counsellorAdd(CounsellorAction.java:123) 
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) 
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) 
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) 
java.lang.reflect.Method.invoke(Method.java:498) 
com.opensymphony.xwork2.DefaultActionInvocation.invokeAction(DefaultActionInvocation.java:452) 
com.opensymphony.xwork2.DefaultActionInvocation.invokeActionOnly(DefaultActionInvocation.java:291) 
...

首先sun.* 或者org.*,都是源码,这些信息不是排查Bug 的重点
一般异常抛出是自己的业务代码有漏洞, 才会触发一系列的信息抛出; 
先找异常信息中的Cause by ... 这是此次异常抛出的原因, 
然后先看异常信息中第一条和当前项目有关业务代码, 
看看信息指定的类的方法某一行为什么抛出空指针异常.
比如上面这个是自己写的CounsellorAction.java  文件中方法counsellorAdd 抛出的异常, 
运行中发现第123 行存在为null 的对象.

4.2 实体类对象转换异常

    此转换对象不能直接强制转换为被转换对象。

HTTP Status 500 - Request processing failed; nested exception is java.lang.ClassCastException:
com.zduod.core.requestentity.RequestUser cannot be cast to com.zduod.core.requestentity.RequestPay

4.3 JSON参数转换异常

    JSON数据传参异常，不能将非数字转换为数字

HTTP Status 500 - Request processing failed; nested exception is com.alibaba.fastjson.JSONException
    ...
root cause
java.lang.NumberFormatException
    java.math.BigDecimal.<init>(BigDecimal.java:494)
    java.math.BigDecimal.<init>(BigDecimal.java:383)
    java.math.BigDecimal.<init>(BigDecimal.java:806)
    com.alibaba.fastjson.util.TypeUtils.castToBigDecimal(TypeUtils.java:194)
    ...

4.4 服务器响应already committed异常

    response 是服务端对客户端请求的一个响应，其中封装了响应头、状态码、内容等；服务端在把response提交到客户端之前，会向缓冲区内写入响应头和状态码，然后将所有内容flush，即将所有缓存输出。这就标志着该次响应已经提交。

    对于当前页面already commitd 已经提交的response 就不能再使用response 执行写操作。

HTTP Status 500 - java.lang.IllegalStateException：Cannot forward a response that is already committd

4.5 前后台交互数据类型不匹配

    后台开发查询用户接口，访问接口

http://localhost:8082/dboot/eouser/queryEOUser，请求JSON数据为

{  "treasureData": "{\"userName\":\"78\",\"userId\":\"2147483648\",\"userPassword\":\"930915\"}"}

    后台响应结果

{
    "timestamp": "2018-07-13T03:05:36.261+0000",
    "status": 500,
    "error": "Internal Server Error",
    "message": "For input string: \"2147483648\"",
    "path": "/dboot/eouser/queryEOUser"
}

    接口响应错误信息为input输入数据为String类型，后台请求体封装实体类定义属性userId为Integer类型。Integer.MAX_VALUE=2147483647，此处2147483648已经不能作为Integer处理。接口数据改为-2147483648 ~ 2147483647之间的整型数据，重新请求接口，后台正常处理请求并返回结果。

{
    "eoUserList": [
        {
            "userId": 1,
            "userName": "eolinker",
            "userNickName": "eolinker",
            "userPassword": "c0bc7b2052c950c1541692eab1284937"
        }
    ],
    "errorMsg": "查询用户成功！",
    "success": true
}

4.6 Mybatis解析实体属性错误

    此处异常为类型异常；异常信息如下

HTTP Status 500 – Internal Server Error
Type Exception Report
Message Request processing failed; nested exception is org.mybatis.spring.MyBatisSystemException: 
nested exception is org.apache.ibatis.reflection.ReflectionException: 
There is no getter for property named 'useId' in 'class com.zduod.manage.face.entity.ZddInformation'

    此处是因为mybatis解析属性错误，信息为useId在实体类中无对应的setter()、getter()方法。检查发现请求参数为userId，实体类属性为userId，也存在对应的setter()、getter()方法。

    此处配置文件mapper.xml中错写userId为useId导致解析数据报错，服务器无法处理请求。

<select id="getListByPage" resultMap="BaseResultMap" parameterType="com.zduod.manage.face.entity.ZddInformation">
    select
    <include refid="Base_Column_List" />
    from zdd_information
    <where>
      <if test="informationId != null" >
        and information_id = #{informationId,jdbcType=VARCHAR}
      </if>
      <if test="userId != null" >
        <!--此处写错userId为#{useId,jdbcType=DECIMAL}-->
        and user_id = #{userId,jdbcType=DECIMAL}
      </if>
    </where>
    order by create_time desc
</select>

4.7 请求数据类型语法错误

    此处异常为JSON数据存在格式错误，嵌套异常，语法错误。

HTTP Status 500 – Internal Server Error
Type Exception Report
Message Request processing failed; nested exception is com.alibaba.fastjson.JSONException: syntax error, expect {, actual string, pos 0
Description The server encountered an unexpected condition that prevented it from fulfilling the request.
Exception
org.springframework.web.util.NestedServletException: Request processing failed; nested exception is com.alibaba.fastjson.JSONException: syntax error, expect {, actual string, pos 0

    异常信息是JSON数据存在语法错误，在 { 大括号嵌套时有问题。我这里是前端是通过JSON数据请求后端接口，仔细检查后JSON数据的格式存在如下问题：JSON请求数据中treasureData的value值嵌套的数据没有完全用{}封装。

修改前:
"treasureData": "{"userId":"2018071211901416892","userPayPassword":"100000","cashBalance":"80""
修改后:
"treasureData": "{"userId":"2018071211901416892","userPayPassword":"100000","cashBalance":"80"}"

五、其他说明

500状态码，问题出现的情况多样，请根据Exception信息分析，进行debug断点调试排查具体原因。

你可以把异常信息贴出来，放到技术问答https://ask.csdn.net/去提个问题，会有人帮助你分析处理问题。

你可以把关键异常信息贴在此文评论区，没有异常信息无法确定具体原因。