在Tomcat中配置404自定義錯誤頁面詳解

更新時間：2017年03月25日 22:00:55 投稿：mdxy-dxy

這篇文章主要介紹了在Tomcat中配置404自定義錯誤頁面全解,需要的朋友可以參考下

一直使用tomcat,今天想到一個問題,自定義404錯誤頁面, 為了獲得很好的用戶感受,是不應當向用戶暴露404這樣的頁面的, 問題的出發(fā)點是我在Struts2中定義錯誤頁面, 在Struts2中是這樣定義的:

 <default-action-ref name="pagenotfound"></default-action-ref>   
 <action name="pagenotfound"> 
       <result>/pagenotfound.html</result> 
 </action>

這就是說在訪問action是.如果沒有找到action就訪問這個頁面,但是我如果我不用.do或者.action的樣式,而直接使用.jsp或者.html的方式來訪問頁面的請,struts就不會處理了.結果是404錯誤依然出現(xiàn).
現(xiàn)在已經不是struts的處理范圍了,那么這應當是應用的處理范圍,經查證,在工程的web.xml中可以設置自定義錯誤頁面,設置如下:

<error-page> 
    <error-code>404</error-code> 
    <location>/pagenotfound.html</location> 
</error-page>

現(xiàn)在再訪問該該工程下面一個不存在的頁面,將跳轉到自定義的pagenotfound頁面,這樣,struts中的那個default-action-ref 配置是可以去掉的了.因為404交給tomcat處理了.

然后,然后我輸入http://localhost/asdfasdfafd一個不存在的地址,結果404依然出現(xiàn),
回頭想一下,剛才我們的web.xml是在某一個應用下面的,他處理的應當是本應用的404,而http://localhost/訪問的是tomcat自已的應用,那么這個web.xml配置就應當在webapp/Root/下面的應用來配了,

Root目錄下面放著Tomcat的應用,把里面換成自已的就行了.
于是現(xiàn)在再進行輸入不存在的地址,成功跳向自定義的錯誤頁面.

Tomcat中404/500 錯誤，自定義錯誤頁面

當服務器出現(xiàn)404、500錯誤時候希望能夠給用戶友好的現(xiàn)實界面
只需要在項目的web.xml中添加一些配置

<error-page>
<error-code>404</error-code>
<location>/NotFound404.jsp</location>
</error-page>


 <error-page>
<error-code>500</error-code>
<location>/NotFound500.jsp</location>
</error-page>

這樣當你在訪問不存在的頁面出錯的頁面時就自動顯示剛才指定的頁面了

<!-- 400錯誤 -->
<error-page>
<error-code>400</error-code>
<location>/error.jsp</location>
</error-page>
<!-- 404 頁面不存在錯誤 -->
<error-page>
<error-code>404</error-code>
<location>/error.jsp</location>
</error-page>
<!-- 500 服務器內部錯誤 -->
<error-page>
<error-code>500</error-code>
<location>/error.jsp</location>
</error-page>
<!-- java.lang.Exception異常錯誤,依據(jù)這個標記可定義多個類似錯誤提示 -->
<error-page>
<exception-type>java.lang.Exception</exception-type>
<location>/error.jsp</location>
</error-page>
<!-- java.lang.NullPointerException異常錯誤,依據(jù)這個標記可定義多個類似錯誤提示 -->
<error-page>
<exception-type>java.lang.NullPointerException </exception-type>
<location>/error.jsp</location>
</error-page>

<error-page>
<exception-type>javax.servlet.ServletException</exception-type>
<location>/error.jsp</location>
</error-page>

具體的如下：
Tomcat 的錯誤頁面是由 org.apache.catalina.valves.ErrorReportValve 類輸出來的。如果想自定義錯誤頁面，不需要修改該類。Servlet 規(guī)范聲明了相關的API，只需要在每個 web 應用的 web.xml 里定義?？砂凑斟e誤類型、錯誤代碼配置。例如：

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
  version="2.5">
<display-name>Welcome to Tomcat</display-name>
<description>
   Welcome to Tomcat
</description>
<error-page>
<error-code>404</error-code>
<location>/errorpages/404.jsp</location>
</error-page>　　

<error-page>
　　<exception-type>java.lang.Exception</exception-type>
　　<location>/errorpages/exception.jsp</location>
　</error-page>

</web-app>

注意錯誤頁面必須以“/”開頭，這樣任何path的404錯誤頁面及exception錯誤都會映射到這兩個文件。然后在本web引用的errorpages下面放置404.jsp, exception.jsp兩個文件。
錯誤頁面 404.jsp:

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ page import="java.io.*" %>
<%@ page import="java.util.*" %>
<html>
<header>
<title>404 page</title>
<body>
<pre>
<%
  Enumeration<String> attributeNames = request.getAttributeNames();
  while (attributeNames.hasMoreElements())
  {
    String attributeName = attributeNames.nextElement();
    Object attribute = request.getAttribute(attributeName);
  out.println("request.attribute['" + attributeName + "'] = " + attribute); 
  }
%>
</pre>

代碼中輸出了所有的 request 中的變量。從中也可以看到訪問哪個文件出錯，跳到哪個錯誤頁面了，從而進行更詳細、更人性化的錯誤處理。例如，提示可能的正確網址等等。
例如：訪問一個不存在的頁面 page_not_exist.html，顯示的信息為：

request.attribute['javax.servlet.forward.request_uri'] = /page_not_exists.html
request.attribute['javax.servlet.forward.context_path'] =
request.attribute['javax.servlet.forward.servlet_path'] = /page_not_exists.html
request.attribute['javax.servlet.forward.path_info'] = /errorpages/404.jsp
request.attribute['javax.servlet.error.message'] = /page_not_exists.html
request.attribute['javax.servlet.error.status_code'] = 404
request.attribute['javax.servlet.error.servlet_name'] = default
request.attribute['javax.servlet.error.request_uri'] = /page_not_exists.html

注意，該錯誤頁面必須大于512字節(jié)，否則IE將不予顯示。因為IE默認只顯示大于512字節(jié)的錯誤頁面。Firefox中正常顯示?？梢蕴砑右恍┢渌畔ⅲ瑢㈨撁娲笮U充到512字節(jié)以上。如果仍不能顯示，請檢查IE設置，將該選項選中。

異常處理頁面 exception.jsp:

<%@ page contentType="text/html; charset=UTF-8" isErrorPage="true" %>
<%@ page import="java.io.*" %>
<html>
<header>
<title>exception page</title>
<body>
<hr/>
<pre>
<%
response.getWriter().println("Exception: " + exception); 

if(exception != null)
{
  response.getWriter().println("<pre>"); 
  exception.printStackTrace(response.getWriter()); 
  response.getWriter().println("</pre>"); 
}

response.getWriter().println("<hr/>"); 
%>

注意isErrorPage熟悉必須為true，才能使用exception對象。exception即捕捉到的異常。此處可以對exception進行處理，比如記錄日志、重定向等等。這里把exception trace打印出來了。
500、505 等錯誤頁面的處理類似于404。

您可能感興趣的文章: