Golang如何读取以Volume形式挂载的ConfigMap数据

ConfigMap通过Volume挂载进容器后，本质就是容器文件系统里的普通文件，不需要调用Kubernetes API，直接用Go标准库做本地文件读取即可。

根据你提供的配置，ConfigMap中存储配置的key为config.json，容器内挂载根目录为/src/config，因此配置文件在容器内的绝对路径为/src/config/config.json，直接读取该路径即可。

基础读取实现（一次性加载） #

用标准库os读取文件内容，再通过encoding/json反序列化到自定义的配置结构体即可，参考代码：

package main

import (
	"encoding/json"
	"os"
)

// ServiceConfig 字段需要和你的JSON配置结构一一对应，按需增删
type ServiceConfig struct {
	ServicePort int    `json:"service_port"`
	LogLevel    string `json:"log_level"`
	DatabaseDSN string `json:"database_dsn"`
}

// LoadConfig 从挂载路径加载配置
func LoadConfig() (*ServiceConfig, error) {
	configFilePath := "/src/config/config.json"
	fileContent, err := os.ReadFile(configFilePath)
	if err != nil {
		return nil, err
	}

	var cfg ServiceConfig
	if err := json.Unmarshal(fileContent, &cfg); err != nil {
		return nil, err
	}
	return &cfg, nil
}

func main() {
	cfg, err := LoadConfig()
	if err != nil {
		panic("配置加载失败: " + err.Error())
	}
	// 业务逻辑直接使用cfg对象即可
}

开发调试优化建议 #

• 本地开发时没有容器内的挂载路径，可以支持通过环境变量覆盖配置路径，比如优先读取CONFIG_PATH环境变量，不存在时再用默认的容器内路径，避免本地运行报文件不存在错误。
• 如果需要配置热更新：Kubernetes默认会在ConfigMap资源变更后，自动同步更新挂载到容器内的对应文件（同步延迟取决于kubelet的同步周期，通常为几十秒）。需要热加载的话可以引入fsnotify库监听配置文件的写入事件，触发配置重新加载逻辑，不需要重启Pod。

常见踩坑说明 #

• 不要使用相对路径读取配置，尽量写绝对路径，避免因为进程启动工作目录不符合预期导致文件读取失败。
• 如果挂载ConfigMap时使用了subPath字段指定挂载单个文件，ConfigMap更新后不会自动同步到容器内，需要重启Pod才能加载新配置，无特殊需求不建议用这种方式挂载整份配置文件。
• 除了挂载为文件，ConfigMap还支持注入为环境变量、启动参数，这两种方式适合零散的键值配置，不适合JSON这类整份结构化配置，你当前选择的挂载文件方式是最适配的。

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