瘦身 P1-5: 出包摘掉文档 UI 的两件 webjars(swagger-ui 3.83 MB + knife4j-openapi3-ui 3.48 MB)

application-server.yml 三处 enabled:false 只关接口、关不掉字节:实测改动前的现网归档 jar
(D:/archive/jar_inject-2026-10-05/prod.jar,137,397,870 B)里 BOOT-INF/lib 218 支、未压缩 136.1 MB,
这两件确实在包内。这里改的是 spring-boot-maven-plugin 的 repackage excludes,不动依赖声明
⇒ mvn spring-boot:run / IDE 走 Maven classpath,本地 dev 仍能开 doc.html;io.swagger.v3 的
515 处注解 import 不受影响。

实证(本机 mvn -o -DskipTests package,BUILD SUCCESS):
  lib 218 → 215 支;swagger-ui 命中 0、knife4j-openapi3-ui 命中 0(starter/core 各 0.04/0.06 MB 留下);
  mapstruct 命中 0(10-09 那笔 pom 摘除至此才在产物里看得见);
  jar 137,507,168 → 129,057,351 B,−8,449,817 B = −6.14%,落在 ±5% 闸门外面(这正是预期的交互,
  SIZE_BASELINE 由发版那一笔改,理由写在运维仓 _deploy_jar_and_restart_both.py 的注释里)。
This commit is contained in:
2026-10-15 14:03:36 +08:00
parent 4536513eea
commit 5ad703fb2e
+21
View File
@@ -163,6 +163,27 @@
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<!-- 文档 UI 的两件 webjars 垃圾挤包:
swagger-ui-5.10.3.jar 3.83 MB + knife4j-openapi3-ui-4.5.0.jar 3.48 MB = 7.31 MB,
实测自现网归档 jar(BOOT-INF/lib 218 支 / 未压缩 136.1 MB)——
application-server.yml 三处 enabled:false 只关接口,关掉不了字节。
这里挪的是 repackage 的 fat jar,不动依赖声明 => mvn spring-boot:run / IDE
走的是 Maven classpath,本地 dev 仍然能打开 doc.html;而 annotation (io.swagger.v3
的 515 处 import)不受影响。
另注:包变瘦 7.31 MB 正卡 scripts/_deploy_jar_and_restart_both.py 的
SIZE_TOLERANCE=0.05 下沿 => SIZE_BASELINE 必须与本改动同批改、同批发布。 -->
<excludes>
<exclude>
<groupId>org.webjars</groupId>
<artifactId>swagger-ui</artifactId>
</exclude>
<exclude>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-openapi3-ui</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>