26.IDEA 专业版中创建简单的 Web 项目并打包部署到本地Tomcat 9

IDEA 中创建简单的 Web 项目并打包部署到本地Tomcat 9

一、创建最简单的 Web 项目

1. 使用 IDEA 创建 Java Web 项目

1. File → New → Project→ 选择Maven→ 勾选Create from archetype→ 选择maven-archetype-webapp（最简单结构，仅含index.jsp）。

   • GroupId:com.example
   • ArtifactId:simple-web
   • Version: Java 8 + Tomcat 9（兼容javax.servlet）。

2. 项目结构：

   simple-web/ ├── src/ │ └── main/ │ ├── resources/ │ └── webapp/ │ ├── WEB-INF/ │ │ └── web.xml (可选) │ └── index.jsp (默认首页) └── pom.xml

2. 配置pom.xml

确保packaging为war，并添加 Servlet API 依赖（provided作用域）：

<packaging>war</packaging><dependencies><!-- Tomcat 9 使用 javax.servlet --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>4.0.1</version><scope>provided</scope></dependency></dependencies><build><finalName>simple-web</finalName><!-- 指定 WAR 文件名 --></build>

3. 添加一个简单的 Servlet（可选）

如果希望用 Java 代码处理请求（而非仅 JSP），创建一个 Servlet：

1. 在src/main/java下创建包com.example.web。
2. 添加HelloServlet.java：

   packagecom.example.web;importjavax.servlet.annotation.WebServlet;importjavax.servlet.http.HttpServlet;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importjava.io.IOException;@WebServlet("/hello")// 访问路径：http://localhost:8080/simple-web/hellopublicclassHelloServletextendsHttpServlet{@OverrideprotectedvoiddoGet(HttpServletRequestreq,HttpServletResponseresp)throwsIOException{resp.getWriter().write("Hello from Servlet (Tomcat 9)!");}}

   • 注意：Tomcat 9 使用javax.servlet（Jakarta EE 9 之前）。

二、打包项目

1. 执行打包

• 在 IDEA 右侧Maven 面板→ 选择Lifecycle → package。
• 或终端运行：

  mvn clean package

• 生成simple-web.war文件在target/目录下。

三、部署到远程服务器的 Tomcat 9

1. 手动部署（备用方案）

1. 上传 WAR 文件：
   • 通过 SCP/SFTP 将target/simple-web.war复制到远程服务器的 Tomcat 的webapps/目录：

     scptarget/simple-web.war user@remote_ip:/path/to/tomcat/webapps/

   • Tomcat 会自动解压 WAR 文件（或重启 Tomcat 强制加载）：

     ./bin/shutdown.sh ./bin/startup.sh

2. 访问应用：
   • 浏览器访问：http://remote_ip:8080/simple-web/（首页index.jsp）。
   • 如果配置了 Servlet，访问：http://remote_ip:8080/simple-web/hello。

常见问题

1. 403 访问拒绝：
   • 检查tomcat-users.xml是否配置了manager-script角色。
   • 确保context.xml未限制远程访问。
2. Servlet 404：
   • 确认@WebServlet路径是否正确。
   • 检查 Tomcat 9 是否兼容javax.servlet（而非jakarta.servlet）。
3. JDK 版本冲突：
   • 确保远程服务器的 JDK 版本与本地开发环境一致。

通过以上步骤，你可以在 IDEA 中创建简单的 Web 项目并部署到远程 Tomcat 9。