3.2 基础配置项说明

本节列出系统运行所需的最基础配置参数，修改后需重启服务生效。

核心配置项

| 配置项 | 默认值 | 说明 | 常用值示例 |
|--------|--------|------|------------|
| server.port | 8080 | HTTP服务监听端口 | 80、443、8080（开发环境建议8080+） |
| app.name | - | 应用标识名，用于日志、监控和注册中心 | order-service、user-api |
| env | dev | 运行环境标识 | dev（开发）、test（测试）、prod（生产） |
| log.level | INFO | 日志输出级别 | DEBUG（排查问题）、INFO（正常）、WARN（生产） |
| charset | UTF-8 | 系统字符编码 | UTF-8（固定，不建议修改） |
| timezone | Asia/Shanghai | 业务时区 | Asia/Shanghai、UTC |

配置示例

# application.yml 示例
server:
  port: 8080

app:
  name: payment-service
  env: prod

log:
  level: WARN
  path: /var/log/app

system:
  timezone: Asia/Shanghai

注意事项

1. 端口冲突：若启动时报"Address already in use"，请检查 server.port 是否被其他进程占用
2. 生产环境：env 设置为 prod 时，日志会自动关闭DEBUG输出，且禁止输出堆栈详情到客户端
3. 字符编码：数据库连接字符集需与此处 charset 保持一致，否则会出现乱码

建议首次部署时仅修改 server.port 和 app.name，其他保持默认即可。