技术支持:Java Web服务|安全机制|性能优化|微服务架构 | 备案号:蜀ICP备2026035467号-3 | www.xservx.com

Java Web服务编程指南

权威、系统、实用的Java Web服务开发全链路知识体系——从JAX-WS到JAX-RS,从RESTful设计到微服务架构,覆盖Spring Boot整合、安全机制、性能调优与生产级部署,助您构建高性能、高可用、可扩展的现代Web服务系统。

本指南以Java Web服务开发实战为核心,结合真实业务场景与行业最佳实践,深入解析服务端设计、客户端集成、API治理、分布式协调等关键环节,帮助开发者跨越从理论到落地的鸿沟。

立即学习

一、Java Web服务核心基础

〈什么是Web服务?为何Java是首选?〉

Web服务是一种基于网络的、平台无关的软件组件,通过标准化协议(如HTTP、XML、JSON)提供可调用的功能接口。它实现了跨系统、跨语言、跨平台的互操作性,是现代分布式系统集成的基石。

Java凭借其“一次编译,处处运行”的跨平台特性、成熟的生态系统(Java EE规范)、强大的工具链(Maven/Gradle)、以及活跃的社区支持,成为构建企业级Web服务的首选语言。尤其在金融、电信、政务等高可靠性要求场景中,Java Web服务占据绝对主导地位。

从底层协议看,Java Web服务主要分为两类:

  • SOAP服务(JAX-WS):基于XML的重量级协议,支持WS-*系列标准(WS-Security、WS-ReliableMessaging、WS-Transaction),适用于强事务性、高安全要求的系统集成;
  • RESTful服务(JAX-RS):基于HTTP的轻量级架构风格,使用JSON/XML传输,符合资源表述状态转移(REST)约束,适用于互联网应用、移动端API、微服务通信。

近年来,随着云原生与微服务架构的普及,JAX-RS规范实现(如Jersey、Spring MVC、Spring WebFlux)逐渐成为主流,因其更契合现代应用对敏捷开发、快速迭代、水平扩展的需求。

〔Java Web服务核心规范演进〕

Java平台的Web服务开发规范由JCP(Java Community Process)制定,其演进路径清晰反映技术趋势:

2002 • JAX-RPC 1.0
〈JAX-RPC(Java API for XML-Based RPC)〉

首个标准化的SOAP服务API,基于SAAJ(SOAP with Attachments API for Java),强制XML绑定,耦合度高,已废弃。

2006 • JAX-WS 2.0
〈JAX-WS(Java API for XML-Based Web Services)〉

替代JAX-RPC,支持SOAP 1.2、MTOM(Message Transmission Optimization Mechanism),引入@WebService、@WebMethod等注解,简化开发。

2008 • JAX-RS 1.0
〈JAX-RS(Java API for RESTful Web Services)〉

首个RESTful服务规范,定义@GET、@POST、@Path等注解,Jersey为参考实现。

2013 • JAX-RS 2.0
〈异步客户端、过滤器链、超媒体支持〉

新增Client API、AsyncInvocation、ContainerResponseFilter,支持服务发现与超媒体控制(HATEOAS)。

2020 • Jakarta EE 9
〈命名空间迁移至jakarta.*,适配Java 11+〉

从javax.*迁移至jakarta.*包路径,为云原生环境优化,支持响应式编程(Reactive Streams)。

〔典型Java Web服务技术栈对比〕

维度 JAX-WS(SOAP) JAX-RS(REST) Spring Web(MVC/WebFlux)
协议 HTTP + SOAP/XML HTTP + JSON/XML HTTP + JSON/XML(MVC) / Reactive Streams(WebFlux)
消息格式 XML为主(支持MTOM二进制) JSON(主流)、XML JSON、XML、Protobuf等
开发复杂度 高(需WSDL生成客户端) 中(注解驱动) 低(Spring Boot快速起步)
事务支持 强(WS-Transaction) 弱(依赖业务层实现) 中(@Transactional + 分布式事务)
适用场景 银行核心系统、ESB集成、政府政务平台 互联网API、移动后端、微服务通信 全栈企业应用、高并发响应式服务
性能表现 中(XML解析开销大) 高(JSON轻量) 极高(WebFlux非阻塞)

二、JAX-WS深度实践:构建企业级SOAP服务

〔JAX-WS核心注解详解〕

JAX-WS 2.3(Jakarta EE 9)通过注解将POJO暴露为Web服务,关键注解如下:

  • @WebService:标记服务端点接口(SEI)或实现类,可指定name、targetNamespace、serviceName;
  • @WebMethod:定义暴露的方法,exclude=true可排除不暴露;
  • @WebParam:自定义参数名,避免生成的arg0等无意义名称;
  • @WebResult:定义返回值名称;
  • @WebFault:自定义异常的SOAP Fault结构;
  • @HandlerChain:绑定处理链(如日志、安全拦截);
  • @MTOM:启用MTOM优化二进制传输(如文件上传)。

示例:一个简单的用户查询服务

import jakarta.jws.*;
import jakarta.jws.soap.SOAPBinding;
import jakarta.xml.ws.*;
@WebService(
  name = "UserService",
  targetNamespace = "http://api.xservx.com/user"
)
@SOAPBinding(style = SOAPBinding.Style.DOCUMENT, use = SOAPBinding.Use.LITERAL)
public class UserServiceImpl {
  @WebMethod(operationName = "getUserById")
  public User getUser(@WebParam(name = "userId") String id) {
    return new User(id, "张三", "zhangsan@xservx.com");
  }
  @WebMethod
  public List getAllUsers() {
    return Arrays.asList(
      new User("U001", "李四", "lisi@xservx.com"),
      new User("U002", "王五", "wangwu@xservx.com")
    );
  }
}

〔WSDL生成与客户端调用〕

服务端部署后,通过?wsdl后缀可获取WSDL文档(如:http://localhost:8080/services/UserService?wsdl)。使用JDK的wsimport工具生成客户端存根:

wsimport -s src -p com.xservx.client -keep http://localhost:8080/services/UserService?wsdl

生成的客户端代码示例:

public class UserServiceImplService extends Service {
  public UserServiceImplService(URL wsdlURL, QName serviceName) {
    super(wsdlURL, serviceName);
  }
  public UserService getUserServicePort() {
    return super.getPort(UserService.class);
  }
}
// 客户端调用
UserService port = new UserServiceImplService(
  new URL("http://localhost:8080/services/UserService?wsdl"),
  new QName("http://api.xservx.com/user", "UserServiceImplService")
).getUserServicePort();
User user = port.getUser("U001");

〔MTOM优化大文件传输〕

当传输二进制数据(如PDF、图片)时,XML会大幅膨胀。MTOM(Message Transmission Optimization Mechanism)通过XOP(XML-binary Optimized Packaging)将二进制部分以附件形式传输,仅在XML中保留引用:

@WebService
@MTOM
public class FileService {
  @WebMethod
  public DataHandler uploadFile(@WebParam(name = "fileName") String name,
                                @WebParam(name = "content") DataHandler content) {
    return content; // 实际处理:保存到存储系统
  }
  @WebMethod
  public DataHandler downloadFile(@WebParam(name = "fileName") String name) {
    return new DataHandler(new FileDataSource("files/" + name));
  }
}

客户端需启用MTOM:

Service service = Service.create(wsdlURL, qname);
FileService port = service.getPort(FileService.class);
BindingProvider bp = (BindingProvider) port;
Binding binding = bp.getBinding();
((SOAPBinding) binding).setMTOMEnabled(true);

三、JAX-RS实战:构建RESTful API

〔JAX-RS核心资源定义〕

JAX-RS 2.1通过注解将Java方法映射为HTTP端点,遵循REST约束(资源标识、无状态、统一接口)。关键注解:

  • @Path:定义资源路径(支持正则、模板变量);
  • @GET@POST@PUT@DELETE:HTTP方法映射;
  • @PathParam@QueryParam@FormParam@MatrixParam:参数绑定;
  • @Produces@Consumes:媒体类型协商(如application/json、application/xml);
  • @Entity:参数对象自动反序列化;
  • @Context:注入UriInfo、HttpHeaders等上下文对象。

示例:用户资源服务

@Path("/users")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class UserResource {
  @GET
  public List getAllUsers() {
    return UserService.getInstance().findAll();
  }
  @GET
  @Path("/{id}")
  public Response getUser(@PathParam("id") String id) {
    User user = UserService.getInstance().findById(id);
    if (user == null) return Response.status(404).build();
    return Response.ok(user).build();
  }
  @POST
  public Response createUser(User user) {
    UserService.getInstance().save(user);
    return Response.status(201).entity(user).build();
  }
  @PUT
  @Path("/{id}")
  public Response updateUser(@PathParam("id") String id, User user) {
    user.setId(id);
    UserService.getInstance().update(user);
    return Response.ok(user).build();
  }
  @DELETE
  @Path("/{id}")
  public Response deleteUser(@PathParam("id") String id) {
    UserService.getInstance().delete(id);
    return Response.noContent().build();
  }
}

〔Jersey参考实现配置〕

Jersey是JAX-RS RI,需在web.xml中配置Servlet:

<servlet>
  <servlet-name>Jersey Web Application</servlet-name>
  <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
  <init-param>
    <param-name>jersey.config.server.provider.packages</param-name>
    <param-value>com.xservx.api</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>Jersey Web Application</servlet-name>
  <url-pattern>/api/*</url-pattern>
</servlet-mapping>

或使用ResourceConfig类:

public class MyApplication extends ResourceConfig {
  public MyApplication() {
    packages("com.xservx.api");
    register(LoggingFeature.class);
  }
}

〔RESTEasy配置与特性〕

RESTEasy是JBoss的JAX-RS实现,支持更多扩展(如Server-Sent Events、CORS)。配置web.xml:

<context-param>
  <param-name>resteasy.scan</param-name>
  <param-value>true</param-value>
</context-param>
<listener>
  <listener-class>org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap</listener-class>
</listener>
<servlet>
  <servlet-name>Resteasy</servlet-name>
  <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>Resteasy</servlet-name>
  <url-pattern>/api/*</url-pattern>
</servlet-mapping>

RESTEasy支持@CacheResponse、@GZIP、@Preauthorize等注解,增强缓存与安全能力。

〔Spring MVC与JAX-RS对比〕

虽然Spring MVC不是JAX-RS规范,但其注解模型高度相似,且功能更强大。常见映射:

JAX-RS Spring MVC
@Path("/users") @RequestMapping("/users")
@GET @GetMapping
@PathParam("id") @PathVariable("id")
@QueryParam("name") @RequestParam("name")
@Produces("application/json") @ResponseBody + produces = "application/json"

Spring MVC优势在于与Spring生态(依赖注入、AOP、事务)无缝集成,且支持@RestController简化开发。

〔HATEOAS超媒体支持〕

HATEOAS(Hypermedia as the Engine of Application State)是REST的第五约束,通过链接引导客户端状态转移。JAX-RS 2.0支持Link与EntityTag:

import jakarta.ws.rs.core.Link;
@GET
@Path("/{id}")
public Response getUser(@PathParam("id") String id) {
  User user = service.findById(id);
  if (user == null) return notFound();
  return ok(user)
    .link("http://api.xservx.com/users/" + id + "/orders", "orders")
    .link("http://api.xservx.com/users/" + id + "/profile", "profile")
    .build();
}

返回JSON中包含_links字段:

{
  "id": "U001",
  "name": "张三",
  "_links": {
    "orders": {"href": "http://api.xservx.com/users/U001/orders"},
    "profile": {"href": "http://api.xservx.com/users/U001/profile"}
  }
}

四、Spring Boot整合Web服务

〔Spring Boot快速构建REST服务〕

Spring Boot通过spring-boot-starter-web自动配置内嵌Tomcat与Spring MVC。最小依赖:

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
</dependency>

创建REST控制器:

@RestController
@RequestMapping("/api/v1")
public class UserController {
  @GetMapping("/users")
  public List getAll() {
    return userService.findAll();
  }
  @GetMapping("/users/{id}")
  public ResponseEntity get(@PathVariable String id) {
    return userService.findById(id)
      .map(ResponseEntity::ok)
      .orElse(ResponseEntity.notFound().build());
  }
  @PostMapping("/users")
  public ResponseEntity create(@RequestBody User user) {
    User saved = userService.save(user);
    return ResponseEntity.created(URI.create("/api/v1/users/" + saved.getId()))
      .body(saved);
  }
}

支持响应式编程(WebFlux):

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
@RestController
public class ReactiveUserController {
  @GetMapping("/users")
  public Flux getAll() {
    return userRepository.findAll();
  }
}

〔Spring Security集成安全机制〕

通过spring-boot-starter-security快速实现认证授权:

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
  @Override
  protected void configure(HttpSecurity http) throws Exception {
    http
      .csrf().disable()
      .authorizeRequests()
        .antMatchers("/api/public/**").permitAll()
        .antMatchers("/api/admin/**").hasRole("ADMIN")
        .anyRequest().authenticated()
      .and()
      .httpBasic(); // 或JWT
  }
  @Bean
  public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder();
  }
}

支持JWT令牌认证,结合spring-security-jwt实现无状态认证。

〔OpenAPI 3.0集成Swagger〕

使用springdoc-openapi-ui自动生成API文档:

<dependency>
  <groupId>org.springdoc</groupId>
  <artifactId>springdoc-openapi-ui</artifactId>
  <version>1.6.14</version>
</dependency>

启动后访问:http://localhost:8080/swagger-ui.html,自动生成交互式文档,支持@Operation、@Parameter注解补充说明。

五、Web服务安全机制详解

〔常见安全威胁与防护策略〕

Web服务面临的主要安全风险:

  • SQL注入:使用JPA/Hibernate参数化查询,避免拼接SQL;
  • XSS攻击:输出时转义HTML实体,设置Content-Security-Policy;
  • CSRF攻击:使用同步令牌(Synchronizer Token Pattern);
  • 重放攻击:添加时间戳+签名机制;
  • 敏感数据泄露:加密存储密码(BCrypt)、传输层HTTPS;
  • API滥用:实施速率限制(Rate Limiting)、请求频率控制。

〔HTTPS与双向认证〕

生产环境必须启用HTTPS(TLS 1.2+)。Spring Boot配置:

server:
  port: 8443
  ssl:
    enabled: true
    key-store: classpath:keystore.jks
    key-store-password: changeit
    key-password: changeit

双向认证(mTLS)要求客户端也提供证书,适用于高安全场景(如金融API网关)。

〔OAuth 2.0与JWT认证〕

现代Web服务普遍采用OAuth 2.0授权框架,结合JWT(JSON Web Token)实现无状态认证:

  • Authorization Code Flow:用户授权后获取Code,换Access Token;
  • Client Credentials Flow:机器对机器认证;
  • Refresh Token:延长会话有效期。

JWT结构:Header.Payload.Signature,示例载荷:

{
  "sub": "user123",
  "iss": "https://auth.xservx.com",
  "iat": 1516239022,
  "exp": 1516242622,
  "roles": ["USER", "ADMIN"]
}

服务端验证签名与有效期,避免数据库查询,提升性能。

〔WS-Security SOAP服务安全〕

JAX-WS支持WS-Security规范,常见机制:

  • Username Token:在SOAP Header中添加用户名/密码摘要;
  • Timestamp:防止重放攻击;
  • Encrypt:加密敏感字段;
  • Sign:数字签名确保完整性。

使用Apache CXF配置:

<jaxws:server id="secureService" serviceClass="com.xservx.UserService">
  <jaxws:inInterceptors>
    <bean class="org.apache.cxf.ws.security.wss4j.WSS4JInInterceptor">
      <constructor-arg>
        <map>
          <entry key="action" value="UsernameToken Timestamp Signature"/>
          <entry key="passwordType" value="PasswordText"/>
          <entry key="passwordCallbackClass" value="com.xservx.PWCallback"/>
        </map>
      </constructor-arg>
    </bean>
  </jaxws:inInterceptors>
</jaxws:server>

六、Web服务性能调优与最佳实践

〔服务端性能优化策略〕

提升Web服务性能的关键措施:

  • 连接池:数据库连接池(HikariCP)、HTTP客户端连接池(Apache HttpClient);
  • 缓存:Redis缓存热点数据(用户信息、配置项);
  • 异步处理:非阻塞I/O(Netty)、响应式编程(Project Reactor);
  • 批处理:批量查询替代循环单查(IN语句);
  • 分页:避免全量查询,使用LIMIT与游标分页;
  • 压缩:启用GZIP压缩(Spring Boot:server.compression.enabled=true);
  • CDN:静态资源走CDN,减少源站压力。

〔客户端性能优化〕

客户端调用服务时的优化技巧:

  • 连接复用:HTTP/1.1 Keep-Alive 或 HTTP/2多路复用;
  • 并发请求:使用CompletableFuture或Flux.merge并发调用;
  • 超时控制:设置连接超时(connect timeout)与读取超时(read timeout);
  • 重试机制:幂等操作可重试(GET),非幂等(POST)需谨慎;
  • 断路器:Hystrix/Sentinel防止雪崩。

示例:Spring Cloud Feign配置超时

feign:
  client:
    config:
      default:
        connectTimeout: 5000
        readTimeout: 10000
        logLevel: full

〔性能测试工具〕

常用压测工具:

  • JMeter:GUI友好,支持复杂场景;
  • Gatling:基于Scala,高并发,实时报告;
  • wrk2:轻量级,高精度延迟分布;
  • ab(Apache Bench):简单快速测试。

JMeter示例脚本:测试/api/users接口吞吐量

组件 配置
线程组 100线程,Ramp-Up 10s,循环10次
HTTP请求 GET http://localhost:8080/api/users
监听器 聚合报告 + 查看结果树

关键指标:TPS(每秒事务数)、响应时间(P95/P99)、错误率。

七、微服务架构下的Web服务设计

〔微服务与单体架构对比〕

微服务将单体应用拆分为小而自治的服务,每个服务可独立开发、部署、扩展:

  • 优势:技术异构、故障隔离、团队自治、弹性扩展;
  • 挑战:分布式事务、服务发现、链路追踪、配置管理、监控告警。

Java生态主流微服务框架:

框架 核心组件 适用场景
Spring Cloud Eureka/Consul + Ribbon/LoadBalancer + Feign/Hystrix + Config + Sleuth + Zipkin 企业级Java应用,Spring生态深度集成
Dubbo Zookeeper + RPC + Dubbo Spring Boot 高性能RPC调用,阿里系广泛使用
Quarkus Kubernetes原生,GraalVM原生镜像 云原生、Serverless,低内存占用
Helidon Oracle官方,MP/SE双模式 轻量级微服务,Java EE开发者友好

〔服务注册与发现〕

微服务需动态感知服务实例地址,常用方案:

  • Eureka:Netflix开源,AP模型,适合互联网应用;
  • Consul:HashiCorp出品,CP模型,支持健康检查与KV存储;
  • Zookeeper:传统分布式协调,CP模型,强一致性;
  • Etcd:Kubernetes默认存储,高可用分布式键值库。

Spring Cloud Eureka配置:

# 服务端(注册中心)
spring:
  application:
    name: discovery-server
eureka:
  server:
    enable-self-preservation: false  # 生产环境建议关闭
  client:
    register-with-eureka: false
    fetch-registry: false
# 客户端(业务服务)
spring:
  application:
    name: user-service
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka/

〔分布式配置中心〕

集中管理配置,支持动态刷新:

  • Spring Cloud Config:Git/ SVN存储配置,配合Bus实现刷新;
  • Nacos:阿里开源,集成配置+服务发现;
  • Apollo:携程开源,支持多环境、权限管理。

Nacos配置示例:

<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
# bootstrap.yml
spring:
  application:
    name: user-service
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        namespace: prod
        group: DEFAULT_GROUP
        file-extension: yaml

〔链路追踪与监控〕

分布式调用链路追踪(Distributed Tracing)是定位性能瓶颈的关键:

  • OpenTelemetry:CNCF统一标准,替代OpenTracing与OpenCensus;
  • Sleuth + Zipkin:Spring Cloud传统方案;
  • Prometheus + Grafana:指标监控;
  • Jaeger:CNCF原生,高性能。

OpenTelemetry Java Agent配置:

java -javaagent:opentelemetry-javaagent.jar \
  -Dotel.service.name=user-service \
  -Dotel.exporter.otlp.endpoint=http://localhost:4317 \
  -jar user-service.jar

数据流向:应用 → Agent → Collector → Storage → Dashboard

八、Web服务测试策略

〔单元测试与集成测试〕

使用JUnit 5 + Mockito测试业务逻辑:

@ExtendWith(MockitoExtension.class)
class UserServiceTest {
  @Mock
  UserRepository userRepository;
  @InjectMocks
  UserService userService;
  @Test
  void testGetUserById() {
    when(userRepository.findById("U001")).thenReturn(Optional.of(new User("U001", "张三")));
    User user = userService.getUser("U001");
    assertEquals("张三", user.getName());
  }
}

集成测试使用Testcontainers启动真实数据库:

@SpringBootTest
class UserIntegrationTest {
  @Container
  static PostgreSQLContainer postgres = new PostgreSQLContainer<>("postgres:14");
  @DynamicPropertySource
  static void configureTestProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.datasource.url", postgres::getJdbcUrl);
    registry.add("spring.datasource.password", postgres::getPassword);
  }
  @Test
  void testUserSave() {
    // 测试真实数据库操作
  }
}

〔API契约测试(Consumer Driven Contracts)〕

Pact框架实现消费者驱动的契约测试,避免服务端变更导致客户端失效:

  • 消费者:定义期望的API响应结构;
  • 生产者:验证是否满足契约;
  • Pact Broker:存储与共享契约文件。

示例(Java):

@Pact(consumer = "user-service")
public RequestResponsePact getUser(PactDslWithProvider builder) {
  return builder
    .given("user exists")
    .uponReceiving("GET /users/U001")
      .path("/users/U001")
      .method("GET")
    .willRespondWith()
      .status(200)
      .body(PactDslJsonBody
        .object()
        .stringType("id")
        .stringType("name")
        .stringType("email"))
    .toPact();
}

〔安全测试〕

自动化安全测试工具:

  • OWASP ZAP:主动扫描漏洞;
  • sqlmap:SQL注入检测;
  • Nessus:全面漏洞扫描;
  • Postman + Newman:CI/CD中集成API测试。

Postman Collection示例:

// 测试登录接口
POST /api/login
Body: {"username":"admin","password":"123456"}
// 断言
pm.test("Status code is 200", function () {
  pm.response.to.have.status(200);
});
pm.test("Response has token", function () {
  pm.expect(pm.response.json().token).to.exist;
});

九、生产级部署与运维

〔Docker容器化部署〕

Docker镜像构建示例:

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java","-Dspring.profiles.active=prod","-jar","app.jar"]

启动容器:

docker run -d --name user-service \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/app \
  user-service:1.0

〔Kubernetes编排〕

K8s Deployment与Service配置:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: user-service
spec:
  replicas: 3
  selector:
    matchLabels:
      app: user-service
  template:
    metadata:
      labels:
        app: user-service
    spec:
      containers:
      - name: user-service
        image: xservx/user-service:1.0
        ports:
        - containerPort: 8080
        env:
        - name: SPRING_PROFILES_ACTIVE
          value: "prod"
---
apiVersion: v1
kind: Service
metadata:
  name: user-service-svc
spec:
  selector:
    app: user-service
  ports:
  - port: 80
    targetPort: 8080
  type: ClusterIP

Ingress暴露服务:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: user-ingress
spec:
  rules:
  - host: api.xservx.com
    http:
      paths:
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: user-service-svc
            port:
              number: 80

〔CI/CD流水线〕

Jenkins Pipeline示例:

pipeline {
  agent any
  stages {
    stage('Build') {
      steps {
        sh 'mvn clean package -DskipTests'
      }
    }
    stage('Test') {
      steps {
        sh 'mvn test'
      }
    }
    stage('Docker Build') {
      steps {
        sh 'docker build -t xservx/user-service:${BUILD_NUMBER} .'
      }
    }
    stage('Deploy') {
      steps {
        sh 'kubectl set image deployment/user-service user-service=xservx/user-service:${BUILD_NUMBER}'
      }
    }
  }
}

〔监控与告警〕

Prometheus监控指标:

指标 描述 告警阈值
http_server_requests_seconds_count 请求总数 -
http_server_requests_seconds_sum 总响应时间 P95 > 1s 触发告警
tomcat_threads_busy Tomcat忙线程数 > 80% 总线程数
jvm_memory_used_bytes 堆内存使用 > 85% Max Heap

Grafana看板可实时监控服务健康状态。