使用部署的 Web 应用程序解决 Dockerized Tomcat 中的 404 错误

Temp mail SuperHeros
使用部署的 Web 应用程序解决 Dockerized Tomcat 中的 404 错误
使用部署的 Web 应用程序解决 Dockerized Tomcat 中的 404 错误
Daniel Marino
2024年11月3日星期日 下午8:50:47

了解 Tomcat Docker 部署中的 404 错误

使用 Docker 在 Tomcat 上设置 Web 应用程序可能是一个简单的过程，但会出现类似以下错误 404状态 很常见并且可能会破坏部署。 404 错误表明服务器无法找到所请求的资源，当应用程序似乎已正确部署在服务器中时，这可能会造成混乱。 网络应用程序 文件夹。此问题可能由多个配置问题引起。

在许多情况下，当应用程序在本地运行而不是在 Docker 容器内运行时，刚接触 Docker 和容器化环境的开发人员会遇到困难。这种不匹配通常与如何 雄猫 处理已部署的应用程序和 Docker 网络设置。确保 战争文件 正确放置和应用程序上下文可访问是关键步骤。

将 Spring Boot 应用程序部署到 Docker 上的 Tomcat 需要特别注意，特别是如果您已将 Tomcat 从 Spring Boot 中排除。需要进行调整以确保 Tomcat 在 Docker 容器内正确地为应用程序提供服务。

本文解决了即使应用程序正确部署在 Docker 中的 Tomcat 上也会收到 404 错误的问题 网络应用程序 文件夹。我们将探讨潜在原因，检查 Docker 和 Tomcat 配置，并概述解决问题的步骤。

命令 使用示例
FROM tomcat:9.0-alpine 此命令指定 Docker 容器的基础映像。在这里，我们使用 Tomcat 9.0 的 Alpine 版本，这是一个轻量级且优化的版本，非常适合最小化 Docker 镜像大小。
ADD assessmentonline.war /usr/local/tomcat/webapps/ 此命令将 WAR 文件添加到 Tomcat webapps 目录中，确保在 Tomcat 启动时部署应用程序。将 Web 应用程序放置在 Docker 容器内的正确目录中至关重要。
CMD ["catalina.sh", "run"] CMD命令指定容器启动时的默认操作。此处，“catalina.sh run”在前台启动 Tomcat，使容器保持活动状态以便为应用程序提供服务。
docker build -t mywebapp1 . 这将从当前目录中的 Dockerfile 构建一个 Docker 映像，并将其标记为“mywebapp1”。此步骤将应用程序和环境打包成稍后可以运行的映像。
docker run -p 80:8080 mywebapp1 这将运行 Docker 映像，将容器的端口 8080（Tomcat 的默认端口）映射到主机上的端口 80。它确保可以通过主机的默认 HTTP 端口访问应用程序。
server.servlet.context-path=/assessmentonline 此 Spring Boot 属性设置应用程序的基本路径。它确保可以通过“/assessmentonline”路径访问应用程序，与预期的 URL 结构相匹配。
docker logs <container-id> 从正在运行的 Docker 容器检索日志。此命令对于诊断部署问题（例如导致 404 响应的错误配置或错误）至关重要。
docker exec -it <container-id> /bin/sh 在正在运行的 Docker 容器内执行交互式 shell 会话。这允许直接访问容器的文件系统以验证 WAR 文件是否正确放置。
ls /usr/local/tomcat/webapps/ 列出 Docker 容器内 webapps 目录的内容。这有助于确认 WAR 文件是否正确部署到 Tomcat。

Tomcat Docker 设置详解及错误 404 解决方案

所提供脚本的第一部分使用 Dockerfile 设置 Tomcat 9.0 容器。命令 来自 tomcat:9.0-alpine 拉取 Tomcat 的轻量级版本，这对于最小化生产环境中的映像大小至关重要。 Alpine 变体通常用于性能优化。接下来， 添加评估在线.war 命令将 WAR 文件放入 网络应用程序 文件夹，确保 Spring Boot 应用程序在 Tomcat 中正确部署。 EXPOSE 命令使端口 8080 可用，这是 Tomcat 服务 Web 请求的地方。

该设置最重要的部分是 CMD [“catalina.sh”，“运行”]，它指示 Docker 在前台运行 Tomcat，使其能够持续为应用程序提供服务。如果没有这个，Docker 容器将在初始启动后立即退出。构建命令 docker build -t mywebapp1 。 创建标记为“mywebapp1”的容器映像，这是稍后运行容器所必需的。脚本的这一部分处理环境配置、部署和容器初始化，这在容器化应用程序中至关重要。

第二个脚本解决方案涉及调整 上下文路径 Spring Boot 应用程序的权限，以确保 Web 应用程序可以正确访问。通过使用定义上下文路径 server.servlet.context-path=/assessmentonline，我们确保对此路径的请求被路由到正确的资源。此设置对于将预期的 URL 结构映射到 Docker 容器内的实际应用程序部署至关重要。不正确的上下文路径是 404 错误的常见原因，解决此问题可确保应用程序在所需的 URL 下可用。

调试 404 错误的另一个关键步骤是使用 码头工人日志 命令。此命令允许您检查容器生成的日志，这些日志提供了有关应用程序是否已正确部署或启动过程中是否出现错误的有价值的信息。此外， docker 执行-it 命令在正在运行的容器中打开一个 shell，使您能够探索文件系统。这对于验证 WAR 文件是否正确放置在 网络应用程序 文件夹以及所有资源是否已正确部署。这些故障排除方法对于识别导致 404 错误的配置问题至关重要。

使用不同方法处理 Tomcat Docker 设置中的 404 错误

使用 Docker 和 Tomcat，重点关注故障排除和后端配置

# Approach 1: Verify WAR Deployment and Check Docker File
FROM tomcat:9.0-alpine
LABEL maintainer="francesco"
ADD assessmentonline.war /usr/local/tomcat/webapps/
EXPOSE 8080
# Ensure Tomcat's catalina.sh is correctly invoked
CMD ["catalina.sh", "run"]
# Build and run the Docker container
docker build -t mywebapp1 .
docker run -p 80:8080 mywebapp1
# Test the URL again: curl http://localhost/assessmentonline/api/healthcheck

Spring Boot中上下文路径配置问题的解决方案

调整 Tomcat 中的 Spring Boot 上下文设置以确保正确的 URL 处理

# Approach 2: Modify Spring Boot Application to Set Proper Context Path
# In your Spring Boot application properties, specify the context path explicitly
server.servlet.context-path=/assessmentonline
# This ensures that the application is accessible under the correct path in Tomcat
# Rebuild the WAR and redeploy to Docker
docker build -t mywebapp1 .
docker run -p 80:8080 mywebapp1
# Test the updated URL: curl http://localhost/assessmentonline/api/healthcheck
# You should now receive a valid response from your application

验证Docker配置并检查日志

使用 Docker 日志进行故障排除以识别与部署或丢失文件相关的问题

# Approach 3: Use Docker Logs to Diagnose 404 Issues
# Check the logs to confirm WAR deployment status
docker logs <container-id>
# Ensure no deployment errors or missing files are reported
# If WAR is not deployed correctly, consider adjusting the Dockerfile or paths
# Use docker exec to explore the running container
docker exec -it <container-id> /bin/sh
# Verify that the WAR file is in the correct directory
ls /usr/local/tomcat/webapps/assessmentonline.war

解决 Docker 中的 Tomcat 和 Spring Boot 部署问题

在 Tomcat 中部署 Spring Boot 应用程序时经常被忽视的一个方面是上下文路径和目录结构的重要性。默认情况下， 雄猫 使用根文件夹进行部署，但如果您的 WAR 文件未使用正确的上下文路径进行正确配置，则可能会导致 404错误。在容器隔离可能隐藏问题的 Docker 环境中尤其如此。一种有效的解决方案是显式设置 Spring Boot 上下文路径以匹配 Tomcat 的目录结构。

另一个关键方面是确保 Docker容器 正确暴露和映射端口。中的错误配置 EXPOSE 指令可能会导致 Tomcat 服务器无法从外部访问，即使它内部运行良好。在这种情况下，检查 Docker 端口映射并验证应用程序是否正在侦听指定端口是排除故障的关键步骤。始终使用以下命令确认映射 docker run 正确的命令 -p 旗帜。

最后，如果 Tomcat 被排除在 Spring Boot 依赖项之外并在 Docker 中作为独立服务运行，那么 Spring Boot 和 Tomcat 之间的集成有时可能会出现问题。确保所有必需的库（例如 JSP 文件和依赖项）都包含在 WAR 中可以防止运行时问题。调试使用 docker logs 直接检查正在运行的容器的文件系统可以提供有价值的见解，帮助识别丢失的资源或不正确的部署。

关于 Dockerized Tomcat 中 404 错误的常见问题

  1. 尽管 WAR 部署成功，为什么我仍收到 404 错误？
  2. 问题可能在于上下文路径不正确。使用 server.servlet.context-path 属性来显式设置应用程序路径。
  3. 如何验证我的 WAR 文件是否已正确部署？
  4. 访问Docker容器并使用 ls /usr/local/tomcat/webapps/ 检查 WAR 文件是否位于正确的目录中。
  5. 如何在Docker中正确暴露Tomcat的端口？
  6. 确保 EXPOSE Dockerfile 中的命令设置为 8080，并且您运行容器 docker run -p 80:8080。
  7. 如果我的应用程序在本地运行，什么会导致 404 错误？
  8. 在 Docker 中，网络隔离或端口冲突可能是一个问题。验证端口映射并运行 docker logs 检查部署问题。
  9. 如何查看Docker容器内的Tomcat日志？
  10. 使用命令 docker logs <container-id> 查看 Tomcat 日志并检查是否有错误或错误配置。

关于修复 Dockerized Tomcat 中的 404 错误的最终想法

在 Docker 化的 Tomcat 环境中处理 404 错误时，主要重点应该是验证 应用 已正确部署在容器内。确保 WAR 文件放置在正确的目录中，并确认端口已正确公开以供外部访问。

此外，检查应用程序配置中的上下文路径并检查 Docker 日志 可以帮助发现任何潜在的问题。通过执行以下步骤，您可以解决大多数部署问题，并通过 Docker 中的 Tomcat 成功为您的 Spring Boot 应用程序提供服务。

来源和参考文献
  1. 详细阐述了 Docker 论坛线程中讨论的类似问题，并深入了解 Docker 部署中 Tomcat 404 错误的可能原因。源码链接： Docker 论坛：Tomcat 404 错误
  2. 介绍了使用 Docker 将 Web 应用程序部署到 Tomcat 的步骤和示例，本文引用并修改了这些步骤和示例。源码链接： Cprime：将 Web 应用程序部署到 Docker 上的 Tomcat