Java Web服务器是部署Java Web应用的核心基础设施,其稳定性与性能直接决定应用的服务质量。从最基础的Servlet容器到完整的企业级应用服务器,Java生态提供了多种选择——每种都有其适用场景与配置策略。
在实际工作中,Java Web服务器配置不仅是安装部署,更涉及:JVM参数调优、线程池配置、SSL证书集成、日志管理、高可用架构设计等多个维度。忽视任一环节,都可能引发线上故障。
我们常接触的服务器分类如下:
从Apache官网下载最新稳定版(如Tomcat 10.1.x),解压即用。核心目录结构如下:
| 目录 | 用途 | 配置要点 |
|---|---|---|
bin/ |
启动/停止脚本(catalina.sh、startup.bat) |
需设置执行权限(Linux);setenv.sh可覆盖环境变量 |
conf/ |
核心配置目录 | server.xml、web.xml、tomcat-users.xml在此 |
lib/ |
共享库文件 | 放置JDBC驱动、工具类JAR(如MySQL驱动mysql-connector-java.jar) |
webapps/ |
应用部署目录 | WAR包自动解压部署;可配置context.xml自定义路径 |
该文件定义服务器整体行为,常见关键节点如下:
<Server port="8005" shutdown="SHUTDOWN">
<Service name="Catalina">
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
connectionTimeout="20000"
redirectPort="8443"
maxThreads="500"
minSpareThreads="25"
acceptCount="100"
URIEncoding="UTF-8"
useBodyEncodingForURI="true" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
<Engine name="Catalina" defaultHost="localhost">
<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
<Context path="" docBase="myapp" debug="0" reloadable="false" />
</Host>
</Engine>
</Service>
</Server>
配置要点说明:
maxThreads:最大并发线程数,建议根据CPU核心数×2估算,过高会导致上下文切换开销增大。acceptCount:排队队列长度,当线程满时新请求排队等待,超过则拒绝。URIEncoding="UTF-8":防止GET请求中文参数乱码的关键配置。reloadable="false":生产环境必须关闭自动重载,避免性能下降与安全风险。Tomcat运行依赖JVM,内存配置直接影响稳定性。在bin/setenv.sh(Linux)或bin/setenv.bat(Windows)中设置:
export CATALINA_OPTS="-Xms1024m -Xmx2048m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Dfile.encoding=UTF-8"
参数含义:
| 参数 | 作用 | 推荐值 |
|---|---|---|
-Xms |
堆初始大小 | 与-Xmx一致,避免动态扩容 |
-Xmx |
堆最大大小 | 物理内存的50%~70%(留空间给系统) |
-XX:MetaspaceSize |
元空间初始大小 | 256MB起,避免频繁GC |
-XX:+UseG1GC |
启用G1垃圾回收器 | Java 8u40+推荐,低延迟 |
通过<Host>标签可实现单服务器部署多个域名应用:
<Host name="api.example.com" appBase="webapps/api" unpackWARs="true" autoDeploy="false">
<Context path="" docBase="/data/apps/api.war" />
</Host>
<Host name="admin.example.com" appBase="webapps/admin" unpackWARs="true" autoDeploy="false">
<Context path="" docBase="/data/apps/admin.war" />
</Host>
注意:appBase为相对路径(基于CATALINA_BASE),docBase建议使用绝对路径,便于权限管理。
生产环境常通过Nginx代理Tomcat,提升静态资源处理能力与负载均衡:
location / {
proxy_pass http://127.0.0.1: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;
proxy_set_header X-Forwarded-Proto $scheme;
}
同时需在server.xml中启用proxyPort="80"和secure="true"以生成正确重定向URL:
<Connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
proxyPort="80" secure="true" scheme="https" />
Jetty以轻量、异步、嵌入式著称,是Eclipse开源项目。其核心优势在于:
server、http、ssl),启动快。spring-boot-starter-jetty)。特别适合微服务网关、WebSocket服务、IoT边缘节点等场景。
下载Jetty 9.4.x或10.x,解压后核心配置文件位于etc/目录:
java -jar start.jar --module=http
# 或启动HTTPS:
java -jar start.jar --module=https,ssl
通过start.ini配置端口与线程池:
jetty.http.port=8080
jetty.http.idleTimeout=30000
jetty.threadPool.maxThreads=200
jetty.threadPool.minThreads=8
jetty.threadPool.idleTimeout=60000
将WAR包放入webapps/目录自动部署;或创建context.xml文件:
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/myapp</Set>
<Set name="war">/opt/apps/myapp.war</Set>
<Set name="extractWAR">true</Set>
<Set name="copyWebDir">false</Set>
</Configure>
置于webapps/目录下,Jetty自动加载。支持热部署(设置scanInterval),但生产环境建议关闭。
生成JKS密钥库:
keytool -genkey -alias myapp -keyalg RSA -keysize 2048 -keystore keystore.jks -validity 365
在start.ini中启用SSL模块并配置:
--module=https
jetty.ssl.port=8443
jetty.sslContext.keyStorePath=etc/keystore.jks
jetty.sslContext.keyStorePassword=changeit
jetty.sslContext.keyManagerPassword=changeit
建议使用PEM证书(兼容Let's Encrypt),需转换为JKS或使用jetty-ssl-context.xml支持PKCS12:
<Set name="keyStorePath">etc/keystore.p12</Set>
<Set name="keyStoreType">PKCS12</Set>
Jetty对WebSocket支持原生完善。部署WebSocket应用需在web.xml中声明:
<web-app>
<listener>
<listener-class>org.eclipse.jetty.websocket.server.WebSocketServerContainerInitializer</listener-class>
</listener>
<servlet>
<servlet-name>MyWebSocket</servlet-name>
<servlet-class>com.example.MyWebSocketServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>MyWebSocket</servlet-name>
<url-pattern>/ws</url-pattern>
</servlet-mapping>
</web-app>
服务端代码示例:
public class MyWebSocketServlet extends WebSocketServlet {
@Override
public void configure(WebSocketServletFactory factory) {
factory.register(MyEndpoint.class);
}
}
生产环境建议启用压缩(permessage-deflate)与心跳机制:
factory.getPolicy().setIdleTimeout(60000);
factory.getPolicy().setInputBufferSize(8192);
factory.getPolicy().setAllowFrameCompression(true);
WildFly是Red Hat维护的JEE 9/10参考实现,支持完整企业规范(EJB、JMS、JTA、JCA等)。其核心组件包括:
适用于金融、电信等对事务一致性要求高的系统。
启动命令:
./standalone.sh -c standalone-full.xml # 启用完整JEE支持
关键配置文件位于standalone/configuration/:
| 文件 | 作用 |
|---|---|
standalone.xml |
运行时配置(默认) |
standalone-full.xml |
启用EJB、JMS等完整服务 |
mgmt-users.properties |
管理用户凭证 |
通过CLI工具添加MySQL数据源:
./jboss-cli.sh
connect
/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-class-name=com.mysql.cj.jdbc.Driver)
data-source add --name=MyDS --driver-name=mysql --connection-url=jdbc:mysql://localhost:3306/mydb --user-name=root --password=secret --jndi-name=java:jboss/datasources/MyDS --enabled=true --use-ccm=true
或直接编辑standalone.xml的<datasources>部分:
<datasource jndi-name="java:jboss/datasources/MyDS" pool-name="MyDS" enabled="true" use-ccm="true">
<connection-url>jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC</connection-url>
<driver>mysql</driver>
<security>
<user-name>root</user-name>
<password>secret</password>
</security>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>50</max-pool-size>
<prefill>true</prefill>
</pool>
</datasource>
部署WAR/JAR方式:
standalone/deployments/(自动生成.dodeploy标记)deploy /path/to/app.war --name=myapp域模式(Domain Mode)用于集中管理多台服务器:
host.xml定义主机控制器(Host Controller)WildFly使用JBoss Log Manager。配置文件logging.properties定义日志级别与输出:
logger.level=INFO
logger.handlers=CONSOLE,FILE
handler.CONSOLE=org.jboss.logmanager.handlers.ConsoleHandler
handler.CONSOLE.level=INFO
handler.CONSOLE.formatter=COLOR-PATTERN
handler.FILE=org.jboss.logmanager.handlers.FileHandler
handler.FILE.level=DEBUG
handler.FILE.properties=autoFlush,path
handler.FILE.autoFlush=true
handler.FILE.path=server.log
handler.FILE.formatter= Pattern
启用JMX监控需在启动脚本中添加:
export JAVA_OPTS="$JAVA_OPTS -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"
使用VisualVM或JConsole连接即可监控线程、内存、MBeans。
所有服务器均支持基于角色的访问控制(RBAC)。以Tomcat为例,在tomcat-users.xml中定义角色与用户:
<tomcat-users>
<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="admin" password="StrongP@ss2026!" roles="manager-gui,admin-gui"/>
</tomcat-users>
⚠️ 严禁在生产环境使用默认密码!建议使用密码哈希(SHA-256):
<user username="admin" password="SHA-256:8c6976e5b5410415bde908bd4dee15dfb167a9c873fc4bb8a81f6f2ab448a918" roles="manager-gui"/>
在应用WEB-INF/web.xml中添加安全约束:
<security-constraint>
<web-resource-collection>
<web-resource-name>SecureApp</web-resource-name>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
Tomcat需配置redirectPort="8443",Jetty需启用HTTPS模块,WildFly需配置 undertow subsystem的SSL虚拟主机。
防止攻击者识别服务器类型进行针对性攻击:
server.xml的<Connector>中添加server="Apache"伪装为Apache。start.ini添加jetty.http.response.header.size=0隐藏Server头。standalone.xml的<http-listener>中设置enabled-protocols="TLSv1.2,TLSv1.3"并移除Server头。启用访问日志(Access Log):
server.xml的<Host>内添加<Valve className="org.apache.catalina.valves.AccessLogValve" ...accesslog模块(java -jar start.jar --add-modules=accesslog)undertow subsystem中配置access-log建议日志格式包含:%h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i",便于SIEM系统分析。
以Tomcat NIO模式为例,关键参数:
| 参数 | 推荐值 | 说明 |
|---|---|---|
maxConnections |
10000 | 最大连接数(非线程数) |
maxThreads |
200~500 | 处理请求的线程数 |
acceptorThreadCount |
1 | 接受连接的线程数,通常为1 |
useAsyncIO |
true | 启用异步IO(NIO.2) |
Tomcat 9+支持HTTP/2(需ALPN库支持):
<Connector port="8443" protocol="org.apache.coyote.http2.Http2Protocol"
sslImplementationName="org.apache.tomcat.util.net.openssl.OpenSSLImplementation"
SSLEnabled="true" ... />
Jetty 9.4+原生支持,WildFly 20+通过Undertow支持。启用HTTP/2可减少请求延迟,提升页面加载速度。
通过配置Gzip压缩与缓存头提升响应速度:
server.xml的<Connector>中添加compression="on" compressionMinSize="2048" noCompressionUserAgents="gozilla, travis"gzip模块,配置jetty-gzip.xmlundertow subsystem添加filter-ref="gzip"同时设置静态资源缓存策略(通过<mime-mapping>或web.xml):
<mime-mapping>
<extension>js</extension>
<mime-type>application/javascript</mime-type>
</mime-mapping>
结合CDN使用,将静态资源(图片、CSS、JS)托管至边缘节点。
使用HikariCP替代默认连接池(Tomcat 8.5+可替换):
maximumPoolSize:根据数据库最大连接数×0.8connectionTimeout:30000ms(超时重试)leakDetectionThreshold:检测连接泄漏配置示例(Spring Boot):
spring.datasource.hikari.maximum-pool-size=30
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.leak-detection-threshold=10000
客户端返回HTTP 503 "Service Unavailable",日志出现java.lang.OutOfMemoryError或Connection refused。
ps aux | grep java确认进程是否存在。$CATALINA_BASE/logs/catalina.outlogs/xxx-yyy-01.logstandalone/log/server.logSEVERE: Error starting endpoint
java.net.BindException: Address already in use: JVM_Bind :8080
→ 端口被占用,使用lsof -i :8080查进程并终止。
应用运行一段时间后崩溃,日志出现java.lang.OutOfMemoryError: Java heap space或Metaspace。
-Xmx值(如2048m)jmap -histo:live分析对象分布-XX:MaxMetaspaceSize=512m-XX:MaxDirectMemorySize客户端请求超时(HTTP 504),或日志显示Connection timed out。
telnet server 8080测试端口连通性。netstat -an | grep :8080 | wc -l
若接近maxConnections,需调优。
maxThreads页面显示中文乱码(□□□),或数据库写入乱码。
URIEncoding="UTF-8"与useBodyEncodingForURI="true"。request.setCharacterEncoding("UTF-8")spring.http.encoding.force=true?useUnicode=true&characterEncoding=UTF-8,数据库表字符集设为utf8mb4。