Tomcat运行时出现NoClassDefFoundError问题解决方案

最近在学习微信公众号开发(开发工具是IntelliJ IDEA),进行网页授权登录获取用户信息时出现了一个相当严重的问题,纠结了我三天,错误信息如下 :

Tomcat运行时出现NoClassDefFoundError问题解决方案_第1张图片

错误发生在获取到用户授权的code后,使用code换取access_token的过程中,具体过程参见 微信开发文档。
负责获取用户授权code的LoginServlet代码如下:

@WebServlet( "/wxLogin")
public class LoginServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //回调地址
        String backUrl = "http://doraemon.imwork.net/Weixin/callBack";
        String url = "https://open.weixin.qq.com/connect/oauth2/authorize?" +
                "appid=" + AuthUtil.APPID +
                "&redirect_uri=" + URLEncoder.encode(backUrl) +
                "&response_type=code" +
                "&scope=snsapi_userinfo" +
                "&state=STATE#wechat_redirect";
        response.sendRedirect(url);
    }
}

回调后的CallBackServlet代码如下:

@WebServlet("/callBack")
public class CallBackServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String code = request.getParameter("code");
"https://api.weixin.qq.com/sns/oauth2/access_token?" +
                "appid=" + AuthUtil.APPID +
                "&secret=" + AuthUtil.APPSECRET +
                "&code=" + code +
                "&grant_type=authorization_code";
         System.out.println(url);

        //获取包含access_token的json
        JSONObject json = AuthUtil.doGetJson(url);
        System.out.println(json);
    }
}

问题就出现在JSONObject json = AuthUtil.doGetJson(url);这一行,AuthUtil.doGetJson方法如下:

 public static JSONObject doGetJson(String url) throws ClientProtocolException, IOException {
        JSONObject json = null;
        DefaultHttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(url);

        HttpResponse response = client.execute(get);
        HttpEntity entity = response.getEntity();
        if (entity != null) {
            String result = EntityUtils.toString(entity, "UTF-8");
            json = JSONObject.fromObject(result);
        }
        get.releaseConnection();
        return json;
    }

方法中的DefaultHttpClient虽然已经过时,但是通过测试程序单独调用这个方法是一丁点问题都没有的。换用HttpUrlConnection封装的方法后问题得以解决,但是以后的项目中不可能不使用HttpClient,所以我决定刨根问底。

在CSDN和Stack Overflow查了无数资料后得到两个关键词:Runtime和ClassPath。使用HttpClient需要Runtime,也就是说编译好的程序在运行时仍然需要与HttpClient有关的jar包,而这个包应该配置在运行时的ClassPath中,那么关键是ClassPath怎么配置?

首先想到的是JDK中的ClassPath,配置后没有任何反应,说明Tomcat的运行时ClassPath与JDK的ClassPath无关。

然后是Tomcat中的ClassPath,我观察到IDEA在启动Tomcat的时候会输出以下信息:



其中有一个CLASSPATH,是在catlina.bat中配置的,我在原有的

set "CLASSPATH=%CLASSPATH%%CATALINA_HOME%\bin\bootstrap.jar"

后加入了httpclient jar包,加入后的代码如下:

set "CLASSPATH=%CLASSPATH%%CATALINA_HOME%\bin\bootstrap.jar;%CATALINA_HOME%\runtimeClassPath\httpclient-4.5.3.jar"

加入后重启Tomacat发现仍然报错,不过错误提示的类名已经改变。说明方法有效,但这种方法太过麻烦。

最后终于找到最佳解决方案:
在IDEA中依次打开File ---> Project Structure ---> Artifacts ---> [项目名称]:war exploded,这是部署项目后的输出文件夹,只要在这个文件夹下添加相应的jar包就可以了。选择在右侧的WEB-INF下建立一个lib文件夹用于存放jar包:


Tomcat运行时出现NoClassDefFoundError问题解决方案_第2张图片

在lib文件夹上右键选择Add Copy of ---> Library Files:


Tomcat运行时出现NoClassDefFoundError问题解决方案_第3张图片

然后添加相应的jar包,我这里直接从Maven里面添加:
Tomcat运行时出现NoClassDefFoundError问题解决方案_第4张图片

完成后依次点击Apply ---> OK,然后Build ---> Build Artifacts ---> [项目名称]:war exploded ---> Rebuild
Tomcat运行时出现NoClassDefFoundError问题解决方案_第5张图片

然后观察到左侧out文件夹下的lib中已经成功添加进了jar包,重启Tomcat就O了!


Tomcat运行时出现NoClassDefFoundError问题解决方案_第6张图片

IDEA用起来确实比Eclipse困难得多啊,不过我喜欢。。。

你可能感兴趣的:(Tomcat运行时出现NoClassDefFoundError问题解决方案)