# spring-profile-demo

**Repository Path**: netbuffer/spring-profile-demo

## Basic Information

- **Project Name**: spring-profile-demo
- **Description**: spring profile test
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-16
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🌱 spring-profile-demo

[![Java](https://img.shields.io/badge/java-21%2B-orange)](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.1.1-brightgreen)](https://spring.io/projects/spring-boot)
[![Docker](https://img.shields.io/badge/Docker-Dragonwell%2021-blue)](https://github.com/dragonwell-project/dragonwell21)

> Spring Profile 示例项目，基于 **Spring Boot 4.1.1** + **Java 21** 构建。

演示 Spring 多环境配置激活、多模块配置文件引入（`spring.config.import`）以及 YAML 中多行文本与 JSON 字符串映射。

## ✨ 特性

- 🌐 多环境配置（`application-dev.yaml` / `application-prod.yaml`）
- 📁 模块化配置导入（`module/sys-*.yaml` / `module/order-*.yaml`）
- 📄 YAML 多行文本与 JSON 解析（Fastjson2）
- 🐉 基于 Alibaba Dragonwell JDK 21 构建

## 🚀 快速开始

### 📥 下载构建产物

前往 [GitHub Releases](../../releases) 页面下载最新的 `spring-profile-demo.jar`。

### ▶️ 直接运行

```bash
java -jar spring-profile-demo.jar
```

本地默认端口见 `application.yaml` 中的 **48791**；Docker 示例使用 **8080**。均可通过环境变量 `SERVER_PORT` 覆盖。

### 🐳 Docker 运行

先构建 jar 包，再构建镜像：

```bash
mvn clean package -DskipTests
docker build -t spring-profile-demo .
```

```bash
docker run -it --rm -p 8080:8080 spring-profile-demo
```

自定义 JVM 参数和环境变量：

```bash
docker run -it --rm -p 8080:8080 \
  -e TZ=Asia/Shanghai \
  -e SPRING_PROFILES_ACTIVE=dev \
  -e JAVA_OPTS="-XX:+PrintCommandLineFlags" \
  spring-profile-demo
```

### 🐙 Docker Compose

```bash
mvn clean package -DskipTests
docker compose up -d
```

## 🔨 构建

项目使用 [Dragonwell JDK 21](https://github.com/dragonwell-project/dragonwell21) 构建，推荐通过 GitHub Actions 自动完成。

```bash
mvn clean package -DskipTests
```

构建产物位于 `target/spring-profile-demo.jar`。

本地开发运行：

```bash
mvn spring-boot:run
```

## 🔄 CI/CD

推送至 `master` / `main` 分支或创建 `v*` 标签时，GitHub Actions 将自动：

1. 🐉 使用 Dragonwell JDK 21 编译打包
2. 📦 上传构建产物（可在 Actions 页面登录下载）
3. 🏷️ 创建 `v*` 标签时，自动发布 jar 包到 GitHub Releases
4. 🐳 创建 `v*` 标签时，自动构建镜像并推送到 ghcr.io

## 📚 外部化配置与环境变量覆盖机制

**是的，这是 Spring Boot 框架原生的核心机制**（基于 Externalized Configuration 外部化配置优先级与 Relaxed Binding 松散绑定规则）。

### 1. 优先级覆盖原理
Spring Boot 预定义了严格的 `PropertySource` 加载与覆盖顺序，**OS 环境变量（OS environment variables）的优先级高于应用配置文件（`application.yaml` / `application.properties`）**。因此，系统或容器中的同名环境变量会直接覆盖配置文件中的预设值。

### 2. Relaxed Binding（松散绑定）转换规则
为了适配不同操作系统环境变量（如 Linux 只支持大写字母、数字及下划线）的命名规范，Spring Boot 提供了 Relaxed Binding 规则进行自动映射转换：
- 点号（`.`）替换为下划线（`_`）
- 横杠（`-`）移除（例如 `api-key` -> `APIKEY`）或部分情况映射为下划线（例如 `api-key` -> `API_KEY`）
- 全部转换为大写

以配置项为例：
```yaml
ai:
  model:
    openai:
      api-key: xxx
```
规范属性名为 `ai.model.openai.api-key`，对应环境变量为：
- `AI_MODEL_OPENAI_API_KEY`
- 或 `AI_MODEL_OPENAI_APIKEY`

当注入 `AI_MODEL_OPENAI_API_KEY` 环境变量时，Spring Boot 会自动匹配并覆盖 `ai.model.openai.api-key`。

### 3. Spring 官方文档参考
- **外部化配置加载顺序与优先级**：
  [Spring Boot Reference - Externalized Configuration](https://docs.spring.io/spring-boot/reference/features/external-config.html)
- **环境变量松散绑定机制（Binding From Environment Variables）**：
  [Spring Boot Reference - Binding From Environment Variables](https://docs.spring.io/spring-boot/reference/features/external-config.html#features.external-config.typesafe-configuration-properties.relaxed-binding.environment-variables)
- **Spring Framework 核心 Environment 抽象**：
  [Spring Framework Reference - Environment Abstraction](https://docs.spring.io/spring-framework/reference/core/beans/environment.html)