Tomcat 出現 404 錯誤後的原因分析詳情 - tomcat 註銷動態日志

當 Tomcat 部署完 SSL 後，訪問頁面出現 404 錯誤的情況，並不一定直接與 SSL 有關係。SSL（Secure Sockets Layer）協議主要負責為應用程序提供加密通訊層，確保數據傳輸的安全性。404 錯誤則是 HTTP 協議的一種狀態碼，表示客户端請求的資源在服務器上不存在。因此，404 錯誤通常與應用程序部署、URL 路徑、文件系統等方面有關，但 SSL 本身並不會導致 404 錯誤。

儘管如此，SSL 的配置過程可能影響到服務器的其他方面，從而間接導致 404 錯誤。這種情況可能出現在 SSL 配置引發了其他配置的變化，導致資源路徑、虛擬主機設置或者映射規則等出現問題。分析和排查時，需要從多個方面進行深入的檢查。

1. 確認 SSL 部署的正確性

在 SSL 部署過程中，我們需要確保以下幾個關鍵步驟沒有出錯，否則即便 SSL 部署成功，也可能引發訪問異常。

證書的正確配置：確保 SSL 證書已成功安裝，並且配置文件中證書鏈完整。通常，SSL 證書和私鑰的路徑需要正確指向 Tomcat 配置文件中的 server.xml 文件，配置語法和路徑必須無誤。例如：
```
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
           maxThreads="150" scheme="https" secure="true"
           clientAuth="false" sslProtocol="TLS"
           keystoreFile="conf/your_keystore.jks" keystorePass="password" />
```
這裏，如果 keystoreFile 或 keystorePass 配置有誤，Tomcat 可能會啓動失敗，或者在 SSL 通道上出現錯誤，儘管這不直接導致 404，但可能影響到訪問路徑。
SSL 端口的配置：在 server.xml 文件中，確保 SSL 服務監聽的端口與客户端訪問時使用的端口一致。如果 SSL 配置了非默認的 443 端口（例如 8443），需要明確地在瀏覽器中使用對應的端口號，否則即便 SSL 配置成功，訪問 URL 時仍可能出現 404 錯誤。

示例：https://yourdomain.com:8443/yourapp

2. 檢查應用程序部署狀態

SSL 部署成功後，接下來應該檢查應用程序本身是否正確部署。出現 404 錯誤的常見原因是應用程序的路徑或資源沒有正確映射到服務器上。

WAR 文件的正確性：Tomcat 通常通過 WAR 文件部署應用程序，WAR 文件需要放在 webapps 目錄中。如果部署的 WAR 文件有損壞、沒有解壓成功或者文件名不正確，Tomcat 會返回 404 錯誤。例如，如果應用名為 myapp，但訪問 URL 是 https://yourdomain.com/anotherapp，這會導致 404 錯誤。
應用程序的啓動狀態：查看 Tomcat 的日誌文件，確保應用程序啓動時沒有拋出異常。常見問題包括應用程序內部依賴錯誤、數據庫連接失敗、初始化失敗等。這些問題可能導致應用沒有完全啓動，頁面訪問時出現 404 錯誤。Tomcat 的 catalina.out 日誌文件可以幫助確認應用是否正確啓動。

日誌中的關鍵字如 SEVERE、ERROR 等，通常標記了啓動過程中的重大錯誤，可以作為排查的起點。

3. URL 路徑的正確性

SSL 部署本身不影響 URL 路徑的解析，但如果 SSL 配置後，修改了 server.xml 或 web.xml 中的路徑配置，可能會影響 URL 映射，從而導致 404 錯誤。

Context Path 的檢查：每個應用在 Tomcat 中都有其特定的 Context Path，這決定了客户端訪問時的 URL。例如，如果應用 myapp 部署在 Tomcat 中的 webapps 目錄下，但沒有設置 Context Path，那麼默認的訪問路徑是 https://yourdomain.com/myapp。如果 server.xml 中設置了 <Context path="/anotherapp" docBase="myapp" />，那麼客户端需要通過 https://yourdomain.com/anotherapp 進行訪問，否則會出現 404 錯誤。
URL 大小寫敏感：Tomcat 對 URL 的大小寫非常敏感。如果資源的路徑是 /MyApp/index.html，而客户端請求的是 /myapp/index.html，即便資源存在，也會返回 404 錯誤。

4. 訪問權限與安全設置

SSL 配置過程中，可能會涉及到一些安全方面的配置，這些配置如果與應用程序的訪問權限發生衝突，也可能導致訪問異常。

權限配置：在應用的 web.xml 中，確保沒有設置限制 SSL 訪問的權限配置。例如，某些應用可能配置了 HTTPS 強制訪問，這時如果使用 HTTP 協議訪問會被重定向到 HTTPS。如果 HTTPS 配置不當，可能會出現 404 錯誤。

  <security-constraint>
      <web-resource-collection>
          <web-resource-name>Protected Area</web-resource-name>
          <url-pattern>/*</url-pattern>
      </web-resource-collection>
      <user-data-constraint>
          <transport-guarantee>CONFIDENTIAL</transport-guarantee>
      </user-data-constraint>
  </security-constraint>

上述配置強制要求所有資源通過 HTTPS 訪問，如果訪問的是 HTTP，會導致錯誤或重定向失效，進而出現 404。

5. Tomcat 和防火牆的配置

網絡環境和防火牆配置也可能影響到頁面的訪問。如果 SSL 部署後修改了 Tomcat 的配置，導致防火牆規則未更新，也可能影響訪問。

防火牆端口：SSL 通信通常使用端口 443，如果使用了非默認端口（如 8443），需要確保服務器防火牆開放了對應端口，否則外部訪問時會阻斷請求。
負載均衡和代理服務器：在一些複雜的部署環境中，Tomcat 可能位於負載均衡器或代理服務器之後。如果這些服務器的配置在 SSL 部署後沒有同步更新，可能會導致請求被阻斷或路徑解析錯誤，進而返回 404 錯誤。檢查代理服務器（如 Nginx、Apache HTTP Server）是否正確轉發了 SSL 請求到 Tomcat，確保路徑沒有問題。

例如，Nginx 代理的常見配置如下：

  server {
      listen 443 ssl;
      server_name yourdomain.com;

      location / {
          proxy_pass http://localhost:8080;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      }
  }

如果代理路徑配置有誤，可能會導致 SSL 請求沒有被正確轉發，客户端會收到 404 錯誤。

6. 案例分析：SSL 部署後的 404 問題

在一個實際案例中，某企業在 Tomcat 上部署了 SSL 後，發現所有頁面訪問都返回了 404 錯誤。經過分析，發現問題的根源是由於在部署 SSL 時，他們修改了 server.xml 中的 Context 配置，並引入了新的 virtual host 配置，導致應用的 Context Path 發生了變化。原來的訪問路徑為 /myapp，但新的 server.xml 配置導致訪問路徑變為了 /newapp，因此原始路徑返回 404。

通過恢復正確的 Context Path 配置，問題得以解決。

總結來説，SSL 部署後出現 404 錯誤，通常是因為其他配置的變更或遺漏引發的。分析時需要從 SSL 配置、應用部署、URL 路徑、權限設置等多個角度進行排查，結合日誌文件中的信息逐步定位問題。