---
url: /zh/operate/configuration.md
description: 服务的配置怎样生效：Spring Boot 的配置来源与宽松命名、map 的键、时长、哪些必须在各节点间一致、开发环境的默认值，以及发现拼错键的检查。
---

# 配置服务

服务的配置方式与任何 Spring Boot 应用一样：`application.yaml`、profile、环境变量和命令行参数，前缀为 `wow`。大多数键的默认值都适合生产环境。本页说明配置怎样生效，以及宿主检查什么。所有的键及其类型和默认值，见[配置项](../reference/configuration)。

## 值从哪里来 {#where-the-values-come-from}

宿主读取 Spring Boot 的环境，所以 Spring Boot 认识的每种来源都有效，并按它的优先级生效：命令行参数优先于环境变量，环境变量优先于 profile 专属的文件，后者又优先于 `application.yaml`。名字按宽松规则绑定：`wow.log.max-poll-interval`、`wow.log.maxPollInterval` 和环境变量 `WOW_LOG_MAXPOLLINTERVAL` 是同一个键。

不要把密钥写进文件。eShop 的配置从环境变量读取每个密钥，并在旁边给出开发用的默认值，例如 `${WOW_INTERNAL_TOKEN:…}`，部署时由它的密钥存储设置这个变量。

## 怎样写值 {#write-the-values}

| 值 | 写法 |
| --- | --- |
| 时长 | `500ms`、`30s`、`5m`，或 ISO-8601 的 `PT30S` |
| 列表 | YAML 列表，或者来自环境变量的逗号分隔字符串：`WOW_INTERNAL_TOKEN=a…,b…` |
| 包含点的 map 的键 | 放在方括号里：`wow.aggregates.[eshop-ordering.order].tenant`、`wow.subscriptions.[OrderSummaryProjection.onEvent].start` |

在 YAML 中，给带方括号的键加上引号，让方括号保留为键的一部分：

```yaml
wow:
  subscriptions:
    "[ShipmentNotifier.onOrderShipped]":
      retry:
        max-attempts: 8
```

## 名字会被检查 {#names-are-checked}

对于与它所提供的任何东西都不匹配的名字，宿主不会忽略，而是拒绝启动：`wow.subscriptions` 下没有对应处理函数的订阅、`wow.aggregates` 下节点不提供的聚合类型、`wow.contexts` 下不在任何类路径上的上下文、没有任何东西提供的 ID 生成器。

## 键会被检查 {#keys-are-checked}

Spring 会忽略没有属性绑定的键，所以拼错的键会一声不响地保留默认值。宿主在启动时把每个 `wow.*` 键与类路径上的配置元数据比较：

* 未知的键记一条警告，并指明它。
* `wow.cosec.`、`wow.http.services.`、`wow.calls.` 或 `wow.internal.` 下的未知键会阻止启动。在 `wow.http.services` 和 `wow.calls.contexts` 下，每一项自己的键也会检查：否则拼错的 `commands` 会让一个服务可以调用每条命令。

环境变量不检查，因为它们的名字无法反向列举。设置部署的环境变量时，对照参考检查它们。

## 哪些必须在各节点间一致 {#what-must-match-across-nodes}

一个服务的节点组成一个集群，所以有些设置必须在每个节点上相同，并且只能按参考所说的方式改变：

* `wow.service`，服务的名字，默认是 `spring.application.name`。
* `wow.log.partitions`：能整除 4,096 的 2 的幂（默认 64），日志有了条目之后就固定不变。在首次部署之前选定。
* `wow.internal.token`：集群令牌。轮换令牌时，先把新令牌加在第二位，再在每个节点上把它移到第一位，最后删除旧令牌。
* 存储以及每个聚合类型的放置：`wow.backend`、`wow.stores`、`wow.log.store`、`wow.snapshot.*`、`wow.aggregates.*.log`。

## 开发与生产 {#development-and-production}

在开发 profile（`dev`、`local`、`test` 或 `demo`，即 `wow.internal.dev-profiles`）中，或者内部端口只绑定在回环网卡上时，有几个默认值会放宽：

| 没有 | 开发环境中 | 生产环境中 |
| --- | --- | --- |
| `DataSource` 或 `MongoClient` | 在内存中运行，并发出警告 | 拒绝启动 |
| 集群令牌 | 内部端口不带令牌运行 | 拒绝启动 |

所以笔记本上不需要数据库，也不需要密钥，而生产节点缺少其中任何一样都无法启动。`wow.ddl: validate` 防止生产节点建表（[PostgreSQL](./postgresql#manage-the-schema)）。

## 查看节点采用了什么 {#see-what-the-node-took}

应用暴露了 Spring Boot Actuator 的 `configprops` 和 `env` 端点时，它们会显示每个键绑定的值。只在管理端口上暴露它们：它们展示的是节点的配置。