S3 桶命令行参数与 Windows Shell 坑

默认配置和 flag 覆盖链路

• 默认配置创建：
  • cfg := config.DefaultConfig()，core/cmd/server/main.go:11
  • 此时 cfg.S3.Bucket == "e2eepan"。
• flag 定义：
  • s3Bucket := flag.String("s3-bucket", "", "S3 bucket name")，core/cmd/server/main.go:15
• 解析后覆盖逻辑：
  • flag.Parse() 之后，执行：
    • if *s3Bucket != "" { cfg.S3.Bucket = *s3Bucket }，core/cmd/server/main.go:24-27
  • 只要 *s3Bucket 不是空字符串，就会覆盖默认桶。
• S3 客户端创建时使用的就是这个 cfg.S3.Bucket：
  • storage.NewS3Client(cfg.S3)，core/internal/api/server.go:85-96
  • S3Client.bucket 直接保存传入的 cfg.Bucket，core/internal/storage/s3.go:1-26

从代码路径上看，如果 flag 能正确解析到值，桶一定会被覆盖，不存在“代码写错”的问题。

复现 1：等号写法 + 冒号，引发错误解析

• 在开发环境中使用如下命令：

  go run ./cmd/server -s3-endpoint=127.0.0.1:9000 -s3-access-key=dummy -s3-secret-key=dummy -s3-bucket=testinit

• 实际打印出来的启动信息类似：

  • S3 Endpoint: 127
  • Bucket: e2eepan

• 说明：

  • -s3-endpoint 只拿到了 127，后面的 .0.0.1:9000 被 shell 拆成了别的 token。
  • -s3-bucket 传入的值要么没有成功到达程序，要么被截断成空，导致覆盖逻辑没有触发。

• 同一环境下，改成空格写法后再试一次。

复现 2：空格写法，一切正常

• 使用命令：

  go run ./cmd/server -s3-endpoint 127.0.0.1:9000 -s3-access-key dummy -s3-secret-key dummy -s3-bucket testinit

• 启动输出：

  • S3 Endpoint: 127.0.0.1:9000
  • Bucket: testinit

• 此时虽然最终会因为无法连接本地 MinIO 报错：

  • failed to check bucket: Get "http://127.0.0.1:9000/testinit/?location=": dial tcp ... connectex: No connection could be made...
  • 但从日志可以确认：
    • -s3-endpoint 正常解析到了完整端点。
    • -s3-bucket 覆盖了默认的 e2eepan。

结论

• Go 的 flag 包并没有问题，后端逻辑也没有问题。
• 真正的问题出在在当前 Windows/Powershell/工具链环境下，对命令行的解析方式：
  • 使用 -flag=value 再加上 : 等符号时，命令被拆成了意料之外的 token。
  • 这导致传入 Go 程序的参数与我们想象的不一样。

避免等号，统一使用空格分隔

• 推荐始终使用：

  go run ./cmd/server `
    -s3-endpoint 192.168.74.101:9000 `
    -s3-access-key 你的AccessKey `
    -s3-secret-key 你的SecretKey `
    -s3-bucket testinit

  或者单行版本：

  go run ./cmd/server -s3-endpoint 192.168.74.101:9000 -s3-access-key 你的AccessKey -s3-secret-key 你的SecretKey -s3-bucket testinit

• 要点：

  • 使用 -flag value 的形式，而不是 -flag=value。
  • 特别是包含 : 的值（如 host:port）时，更要避免等号写法。

如何快速确认解析是否正确

• 启动时关注核心日志中的几行：
  • S3 Endpoint: ...
  • Bucket: ...
• 如果发现：
  • 端点被截断（比如只剩下 127），或者
  • 桶名仍然是 e2eepan，
  • 就要优先怀疑命令行写法，而不是后端代码。