1. JavaWeb项目打包前的准备工作在开始打包JavaWeb项目之前我们需要做好充分的准备工作。首先确保你的开发环境已经安装了JDK建议1.8或以上版本、Maven3.6.0和Tomcat9.0。我推荐使用IntelliJ IDEA作为开发工具它对JavaWeb项目有很好的支持。注意不同版本的Tomcat对Servlet和JSP规范的支持有所不同请确保你的项目使用的规范版本与目标Tomcat版本兼容。1.1 项目结构检查一个标准的JavaWeb项目应该包含以下目录结构project-root/ ├── src/ │ ├── main/ │ │ ├── java/ # Java源代码 │ │ ├── resources/ # 配置文件 │ │ └── webapp/ # Web资源 │ │ ├── WEB-INF/ │ │ │ ├── web.xml │ │ │ └── classes/ │ │ └── index.jsp └── pom.xml # Maven配置文件确保你的web.xml文件配置正确特别是Servlet映射和欢迎页面设置。我曾经遇到过因为web.xml中Servlet路径配置错误导致404的问题排查了很久才发现。1.2 依赖管理使用Maven管理依赖时检查pom.xml中的几个关键配置packagingwar/packaging !-- 必须设置为war -- properties project.build.sourceEncodingUTF-8/projectEncoding maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies !-- Servlet API依赖 -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency !-- 其他项目依赖... -- /dependencies提示scope设置为provided的依赖表示该依赖由运行环境如Tomcat提供不会打包到最终的war文件中。2. 使用Maven打包JavaWeb项目2.1 清理和打包命令在项目根目录下执行以下Maven命令mvn clean package这个命令会执行以下操作清理target目录clean阶段编译源代码compile阶段运行测试test阶段打包项目package阶段打包成功后你会在target目录下看到生成的war文件通常命名为项目名-版本.war例如mywebapp-1.0.war。2.2 打包常见问题解决问题1编码GBK的不可映射字符解决方案在pom.xml中添加编码配置properties project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties问题2依赖冲突使用以下命令分析依赖树mvn dependency:tree对于冲突的依赖可以使用exclusions排除特定版本dependency groupIdcom.example/groupId artifactIdexample-lib/artifactId version1.0/version exclusions exclusion groupIdorg.conflict/groupId artifactIdconflict-lib/artifactId /exclusion /exclusions /dependency问题3资源文件未打包确保在pom.xml中正确配置了资源目录build resources resource directorysrc/main/resources/directory filteringtrue/filtering /resource /resources /build3. Tomcat环境配置与部署3.1 Tomcat安装与配置从Apache官网下载Tomcat二进制包建议9.0.x版本解压到指定目录例如/opt/tomcatLinux或C:\tomcatWindows配置环境变量可选CATALINA_HOME: Tomcat安装目录将$CATALINA_HOME/bin添加到PATH3.2 部署War包到Tomcat有三种主要部署方式方式1直接复制到webapps目录将war文件复制到$CATALINA_HOME/webapps/目录下Tomcat会自动解压并部署。cp target/mywebapp.war $CATALINA_HOME/webapps/方式2使用Manager应用部署访问http://localhost:8080/manager/html输入配置的用户名密码需要在conf/tomcat-users.xml中配置在WAR file to deploy部分上传war文件方式3修改server.xml配置在$CATALINA_HOME/conf/server.xml的Host标签内添加Context path/myapp docBase/path/to/mywebapp.war /警告生产环境不建议使用这种方式因为它需要修改Tomcat主配置文件不利于维护。3.3 部署常见问题解决问题1端口冲突检查并修改conf/server.xml中的端口配置Connector port8080 protocolHTTP/1.1 ... /问题2内存不足在bin/catalina.shLinux或bin/catalina.batWindows中设置JVM参数export JAVA_OPTS-Xms512m -Xmx1024m -XX:MaxPermSize256m问题3应用上下文路径问题如果你希望应用部署在根路径即直接通过http://localhost:8080/访问有两种方法将war文件命名为ROOT.war删除webapps/ROOT目录然后创建一个名为ROOT的目录把你的应用内容放进去4. 启动Tomcat与验证部署4.1 启动和停止Tomcat启动Tomcat$CATALINA_HOME/bin/startup.sh # Linux %CATALINA_HOME%\bin\startup.bat # Windows停止Tomcat$CATALINA_HOME/bin/shutdown.sh # Linux %CATALINA_HOME%\bin\shutdown.bat # Windows4.2 验证部署是否成功查看日志文件$CATALINA_HOME/logs/catalina.out确认没有错误信息访问http://localhost:8080/your-app-context应该能看到你的应用页面检查$CATALINA_HOME/webapps目录应该能看到你的应用目录与war文件名相同不带.war后缀4.3 生产环境优化建议连接器配置优化Connector port8080 protocolorg.apache.coyote.http11.Http11NioProtocol maxThreads200 minSpareThreads10 enableLookupsfalse acceptCount100 connectionTimeout20000 redirectPort8443 /JVM参数优化export JAVA_OPTS-server -Xms2048m -Xmx2048m -XX:NewSize512m -XX:MaxNewSize512m -XX:PermSize256m -XX:MaxPermSize256m -XX:DisableExplicitGC禁用不必要功能删除webapps目录下的示例应用docs, examples, host-manager等禁用AJP连接器除非你需要5. 高级部署技巧与自动化5.1 使用Maven插件自动化部署在pom.xml中添加Tomcat Maven插件build plugins plugin groupIdorg.apache.tomcat.maven/groupId artifactIdtomcat7-maven-plugin/artifactId version2.2/version configuration urlhttp://localhost:8080/manager/text/url servertomcat/server path/myapp/path /configuration /plugin /plugins /build然后在~/.m2/settings.xml中配置Tomcat用户servers server idtomcat/id usernameadmin/username passwordadmin123/password /server /servers部署命令mvn tomcat7:deploy5.2 使用Docker部署Tomcat应用创建DockerfileFROM tomcat:9.0 COPY target/mywebapp.war /usr/local/tomcat/webapps/ EXPOSE 8080 CMD [catalina.sh, run]构建并运行docker build -t mywebapp . docker run -d -p 8080:8080 --name mywebapp-container mywebapp5.3 持续集成/持续部署(CI/CD)集成以Jenkins为例的部署流程配置源代码仓库Git/SVN设置构建触发器代码推送时触发添加构建步骤mvn clean package scp target/mywebapp.war userserver:/opt/tomcat/webapps/ ssh userserver /opt/tomcat/bin/shutdown.sh /opt/tomcat/bin/startup.sh配置构建后操作邮件通知等6. 常见问题深度解析6.1 类加载问题Tomcat的类加载机制与标准Java应用不同遵循以下顺序Bootstrap classes (JVM)System classes (JRE)/commonclasses (Tomcat)/webapps/yourapp/WEB-INF/classes/webapps/yourapp/WEB-INF/lib/*.jar常见问题NoClassDefFoundError通常是因为依赖的类不在WEB-INF/lib下ClassCastException同一个类被不同类加载器加载解决方案确保所有依赖都打包到WEB-INF/lib避免在Tomcat的lib目录和WEB-INF/lib中重复放置相同的JAR6.2 内存泄漏排查Tomcat应用常见内存泄漏源静态集合持有对象引用未关闭的数据库连接线程未正确终止第三方库的内存泄漏排查工具JDK自带的jvisualvmEclipse Memory Analyzer Tool (MAT)Tomcat Manager的Find leaks功能6.3 会话持久化配置在生产环境中建议配置会话持久化以防止服务器重启时会话丢失在conf/context.xml中添加Manager classNameorg.apache.catalina.session.PersistentManager saveOnRestarttrue Store classNameorg.apache.catalina.session.FileStore directory./sessions/ /Manager对于集群环境可以使用Redis等外部存储Manager classNameorg.apache.catalina.session.PersistentManager distributabletrue Store classNameorg.apache.catalina.session.RedisSessionStore hostredis.example.com port6379 passwordyourpassword database0 timeout2000/ /Manager7. 性能监控与调优7.1 Tomcat监控指标关键监控指标请求处理时间活动会话数JVM内存使用情况线程池状态配置JMX监控在catalina.sh中添加export CATALINA_OPTS -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port9010 -Dcom.sun.management.jmxremote.sslfalse -Dcom.sun.management.jmxremote.authenticatefalse7.2 连接池配置推荐使用HikariCP作为数据库连接池在context.xml中配置Resource namejdbc/MyDB authContainer typejavax.sql.DataSource factorycom.zaxxer.hikari.HikariJNDIFactory jdbcUrljdbc:mysql://localhost:3306/mydb usernameuser passwordpassword maximumPoolSize20 connectionTimeout30000 idleTimeout600000 maxLifetime1800000 driverClassNamecom.mysql.jdbc.Driver/7.3 静态资源优化配置静态资源缓存在web.xml中添加mime-mapping extensionjs/extension mime-typeapplication/javascript/mime-type /mime-mapping filter filter-nameExpiresFilter/filter-name filter-classorg.apache.catalina.filters.ExpiresFilter/filter-class init-param param-nameExpiresByType application/javascript/param-name param-valueaccess plus 1 year/param-value /init-param /filter8. 安全加固建议8.1 基本安全措施删除默认的Tomcat管理用户或修改强密码禁用不必要的管理应用host-manager, manager更新到最新的Tomcat版本配置安全约束security-constraint web-resource-collection web-resource-nameProtected Area/web-resource-name url-pattern/admin/*/url-pattern /web-resource-collection auth-constraint role-nameadmin/role-name /auth-constraint /security-constraint8.2 SSL/TLS配置生成密钥库keytool -genkey -alias tomcat -keyalg RSA -keystore /path/to/keystore配置server.xmlConnector port8443 protocolorg.apache.coyote.http11.Http11NioProtocol maxThreads150 SSLEnabledtrue SSLHostConfig Certificate certificateKeystoreFile/path/to/keystore certificateKeystorePasswordchangeit typeRSA / /SSLHostConfig /Connector8.3 防止常见攻击CSRF防护使用同步令牌模式XSS防护配置过滤器对所有请求参数进行HTML转义点击劫持防护添加HTTP头response.setHeader(X-Frame-Options, DENY);内容安全策略response.setHeader(Content-Security-Policy, default-src self);9. 日志配置与管理9.1 Tomcat日志配置conf/logging.properties关键配置handlers 1catalina.org.apache.juli.AsyncFileHandler, 2localhost.org.apache.juli.AsyncFileHandler, 3manager.org.apache.juli.AsyncFileHandler, 4host-manager.org.apache.juli.AsyncFileHandler, java.util.logging.ConsoleHandler .handlers 1catalina.org.apache.juli.AsyncFileHandler, java.util.logging.ConsoleHandler 1catalina.org.apache.juli.AsyncFileHandler.level FINE 1catalina.org.apache.juli.AsyncFileHandler.directory ${catalina.base}/logs 1catalina.org.apache.juli.AsyncFileHandler.prefix catalina. 1catalina.org.apache.juli.AsyncFileHandler.encoding UTF-89.2 应用日志集成推荐使用SLF4J Logbacklogback.xml配置示例configuration appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender file${catalina.base}/logs/myapp.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePattern${catalina.base}/logs/myapp.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n/pattern /encoder /appender root levelINFO appender-ref refFILE / /root /configuration9.3 日志分析工具ELK Stack(Elasticsearch Logstash Kibana)GraylogSplunk基本日志收集配置Logstashinput { file { path /opt/tomcat/logs/*.log start_position beginning } } filter { grok { match { message %{TIMESTAMP_ISO8601:timestamp} \[%{DATA:thread}\] %{LOGLEVEL:loglevel} %{DATA:logger} - %{GREEDYDATA:message} } } } output { elasticsearch { hosts [localhost:9200] } }10. 实际部署案例分享10.1 传统物理服务器部署部署架构前端Nginx反向代理 负载均衡后端多Tomcat实例会话共享Redis数据库MySQL主从部署步骤在每台服务器上安装相同版本的Tomcat配置Nginx负载均衡upstream tomcat_cluster { server 192.168.1.101:8080; server 192.168.1.102:8080; server 192.168.1.103:8080; } server { listen 80; server_name example.com; location / { proxy_pass http://tomcat_cluster; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }配置Tomcat集群在server.xml中取消注释以下部分Cluster classNameorg.apache.catalina.ha.tcp.SimpleTcpCluster/10.2 云环境部署AWS部署示例创建EC2实例安装Tomcat和Java配置安全组开放8080端口使用Elastic Load Balancer (ELB)分发流量配置Auto Scaling组实现自动扩展Terraform配置示例resource aws_instance tomcat { ami ami-0c55b159cbfafe1f0 instance_type t2.micro user_data -EOF #!/bin/bash yum install -y java-1.8.0-openjdk wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.45/bin/apache-tomcat-9.0.45.tar.gz tar xzf apache-tomcat-9.0.45.tar.gz -C /opt /opt/apache-tomcat-9.0.45/bin/startup.sh EOF } resource aws_lb tomcat_lb { name tomcat-lb internal false load_balancer_type application security_groups [aws_security_group.lb_sg.id] subnets [aws_subnet.public.*.id] } resource aws_lb_listener front_end { load_balancer_arn aws_lb.tomcat_lb.arn port 80 protocol HTTP default_action { type forward target_group_arn aws_lb_target_group.tomcat.arn } }10.3 容器化部署进阶使用Docker Compose部署多容器应用version: 3 services: tomcat: image: tomcat:9.0 ports: - 8080:8080 volumes: - ./mywebapp.war:/usr/local/tomcat/webapps/ROOT.war depends_on: - redis environment: - CATALINA_OPTS-Dredis.hostredis redis: image: redis:alpine ports: - 6379:6379 volumes: - redis_data:/data volumes: redis_data:Kubernetes部署示例apiVersion: apps/v1 kind: Deployment metadata: name: tomcat-deployment spec: replicas: 3 selector: matchLabels: app: tomcat template: metadata: labels: app: tomcat spec: containers: - name: tomcat image: tomcat:9.0 ports: - containerPort: 8080 volumeMounts: - name: app-volume mountPath: /usr/local/tomcat/webapps/ROOT.war subPath: ROOT.war volumes: - name: app-volume configMap: name: mywebapp-config --- apiVersion: v1 kind: Service metadata: name: tomcat-service spec: selector: app: tomcat ports: - protocol: TCP port: 80 targetPort: 8080 type: LoadBalancer11. 维护与故障排除11.1 日常维护任务日志轮转配置logrotate定期压缩和删除旧日志监控磁盘空间特别是日志目录和临时目录定期备份包括应用数据、配置文件和数据库版本升级定期检查并应用Tomcat安全更新11.2 常见故障排查问题1应用无法启动排查步骤检查catalina.out日志确认war文件完整可以手动解压检查检查依赖是否完整检查端口是否被占用问题2内存泄漏排查工具jmap -histo pid查看对象分布jstack pid查看线程状态jstat -gcutil pid查看GC情况问题3性能下降排查方向数据库连接池配置JVM内存配置线程池配置慢SQL查询11.3 热部署技巧开发环境下可以配置热部署在context.xml中添加Context reloadabletrue或者在Maven中配置plugin groupIdorg.apache.tomcat.maven/groupId artifactIdtomcat7-maven-plugin/artifactId version2.2/version configuration path//path reloadabletrue/reloadable /configuration /plugin警告生产环境切勿开启热部署功能会导致内存泄漏和性能问题。12. 从部署到上线的完整流程12.1 预生产环境验证功能测试确保所有功能按预期工作性能测试使用JMeter等工具模拟用户负载安全扫描使用OWASP ZAP等工具检查漏洞兼容性测试在不同浏览器和设备上验证12.2 上线检查清单[ ] 备份当前生产环境[ ] 验证数据库迁移脚本[ ] 检查配置文件中的生产环境参数[ ] 准备回滚方案[ ] 通知相关团队运维、客服等12.3 蓝绿部署策略准备两套相同的生产环境蓝和绿当前用户访问蓝环境将新版本部署到绿环境并进行验证切换负载均衡器指向绿环境蓝环境变为备用或用于下一次部署实现示例Nginx配置# 初始配置 upstream production { server blue.example.com; } # 切换配置 upstream production { server green.example.com; }12.4 监控与反馈上线后监控关键指标错误率响应时间系统资源使用率业务指标如订单量、用户活跃度配置告警规则例如5分钟内错误率超过1%平均响应时间超过2秒JVM内存使用超过90%
