Spring Boot+Angular容器化部署如何动态更新assets下env.json配置

核心逻辑是把Angular配置的注入时机从前端构建阶段后移到容器启动/请求响应阶段，完全复用Spring Boot原生的配置加载能力，不需要针对不同环境单独构建镜像，天然适配K8s的环境变量、ConfigMap挂载等配置注入方式。

第一步：改造Angular侧配置读取逻辑 #

不要用Angular CLI自带的environment.ts/environment.prod.ts这类构建期硬编码的配置，改成运行时拉取配置：

• 保留src/assets/env.json作为配置占位文件，内容只留需要的key，value可以填空字符串或者占位符，正常随前端构建打进Spring Boot的静态资源目录即可，构建阶段不需要注入任何环境相关的值。
• 新增应用初始化拦截逻辑，在Angular应用启动前，主动发起HTTP请求拉取/assets/env.json的内容，将配置存入全局服务，所有业务代码统一从这个全局服务读取配置，不依赖构建期变量。
• 给env.json的请求加上不缓存的参数配置，避免浏览器缓存旧配置导致环境切换不生效。

第二步：Spring Boot侧实现动态配置返回（推荐方案，代码量极小无侵入） #

不需要修改jar包内的静态文件，直接给env.json的路径加一个接口映射，优先级高于静态资源，请求到达时动态返回当前环境的配置即可，核心代码不到20行：

@RestController
public class AngularEnvController {
    @Autowired
    private Environment springEnv;

    // 维护env.json的key和Spring Boot配置key的映射关系
    private static final Map<String, String> CONFIG_MAPPING = Map.of(
        "apiBaseUrl", "angular.config.api-base-url",
        "ossEndpoint", "angular.config.oss-endpoint",
        "appVersion", "angular.config.app-version"
    );

    @GetMapping(value = "/assets/env.json", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<Map<String, String>> getEnvConfig() {
        Map<String, String> envConfig = new HashMap<>();
        CONFIG_MAPPING.forEach((jsonKey, configKey) -> {
            // 按Spring Boot原生优先级取配置：启动参数>环境变量>挂载的配置文件>jar包内默认配置
            envConfig.put(jsonKey, springEnv.getProperty(configKey, ""));
        });
        // 加响应头禁止缓存，避免前端拿到旧配置
        return ResponseEntity.ok()
                .header("Cache-Control", "no-store")
                .body(envConfig);
    }
}

这个方案的优势：

• 完全兼容Spring Boot所有配置源，不管是K8s注入的环境变量、挂载的ConfigMap格式的application.yml、还是启动传的参数，都能自动读取，不需要自己写配置加载逻辑。
• 不需要修改打包后的静态资源，不需要处理jar包内文件读写的权限问题，没有文件替换失败的风险。
• 配置永远是实时最新的，不存在启动时替换失败、配置不生效的问题。

备选方案：启动脚本替换静态资源（不需要改Java代码） #

如果不想修改后端业务代码，可以在容器启动阶段完成env.json的替换，利用Spring Boot静态资源加载的优先级规则（外部目录的静态资源优先级高于jar包内的资源）实现：

1. 前端构建时把env.json模板放到镜像内的固定模板目录，比如/opt/app/templates/env.json，模板里用${ENV_VAR_NAME}格式写占位符。
2. 写容器启动entrypoint脚本，启动Spring Boot前先做替换：

#!/bin/sh
# 创建外部静态资源目录
mkdir -p /opt/app/static/assets/
# 用环境变量替换模板里的占位符，生成实际的env.json
envsubst < /opt/app/templates/env.json > /opt/app/static/assets/env.json
# 启动Spring Boot应用，外部static目录下的资源会优先加载
exec java $JAVA_OPTS -jar /opt/app/app.jar

3. Dockerfile里把脚本设为启动入口，基础镜像里提前安装gettext包（提供envsubst命令）即可。

K8s部署适配 #

两种方案都可以无缝适配K8s的常规配置方式，不需要重新构建镜像：

• 环境变量注入：直接在Deployment的env字段配置对应参数，或者用envFrom批量导入ConfigMap/Secret里的键值对。
• 配置文件挂载：如果用动态接口方案，直接把配置写到挂载的application.yml里即可，Spring Boot会自动加载；如果用启动脚本方案，可以直接把ConfigMap里存好的env.json挂载到/opt/app/static/assets/env.json路径，跳过替换步骤直接生效。
• 敏感配置（比如密钥、第三方凭证）可以存在Secret里，和普通配置用同样的方式注入，不会明文打包在镜像里。

避坑提示 #

• 不要在Angular构建阶段注入环境相关参数，否则改配置必须重新打包，无法实现单镜像多环境部署的目标。
• 如果用启动脚本替换方案，注意给容器内的静态资源目录开写权限，避免权限不足导致替换失败。
• 配置里如果有特殊字符，用envsubst替换的时候注意转义，避免生成非法JSON格式。

内容的提问来源于stack exchange，提问作者user11115384