flipped-aurora/gin-vue-admin · error

minio client 初始化失败, err:

Error message

minio client 初始化失败, err:

What it means

This error is returned by Minio.UploadFile when newMinioClient() fails to construct the MinIO client. Initialization fails on invalid endpoint format, unresolvable/invalid address, or TLS/credential setup errors reported by the minio-go library. The underlying error is appended after the 'minio client 初始化失败, err:' prefix.

Source

Thrown at server/utils/upload/minio_oss.go:46

func newMinioClient() (*minio.Client, error) {
	cfg := global.GVA_CONFIG.Minio
	endpoint := strings.TrimPrefix(strings.TrimPrefix(cfg.Endpoint, "https://"), "http://")

	minioClient, err := minio.New(endpoint, &minio.Options{
		Creds:  credentials.NewStaticV4(cfg.AccessKeyId, cfg.AccessKeySecret, ""),
		Secure: cfg.UseSSL, // Set to true if using https
	})
	if err != nil {
		return nil, err
	}
	return minioClient, nil
}

func (m *Minio) UploadFile(ctx context.Context, file *multipart.FileHeader) (filePathres, key string, uploadErr error) {
	client, err := newMinioClient()
	if err != nil {
		logger.WithCtx(ctx).Mod("upload").Err(err).Error("minio client 初始化失败")
		return "", "", errors.New("minio client 初始化失败, err:" + err.Error())
	}

	f, openError := file.Open()
	// mutipart.File to os.File
	if openError != nil {
		logger.WithCtx(ctx).Mod("upload").Err(openError).Error("function file.Open() Failed")
		return "", "", errors.New("function file.Open() Failed, err:" + openError.Error())
	}

	filecontent := bytes.Buffer{}
	_, err = io.Copy(&filecontent, f)
	if err != nil {
		logger.WithCtx(ctx).Mod("upload").Err(err).Error("读取文件失败")
		return "", "", errors.New("读取文件失败, err:" + err.Error())
	}
	f.Close() // 创建文件 defer 关闭

	// 对文件名进行加密存储

View on GitHub (pinned to 3136500ef3)

Solutions

1. Check the appended error and fix local.minio config: endpoint must be host:port (e.g. '127.0.0.1:9000'), with use-ssl controlling TLS rather than a URL scheme.
2. Verify the MinIO host resolves and is reachable: ping/nc to the endpoint from the app container.
3. Ensure MinIO container/service is running and the port is published/reachable from the app.
4. Validate access-key/secret-key are set correctly (invalid creds usually surface later, but empty values can break client setup).

Example fix

// before (config.yaml)
minio:
  address: http://minio:9000   # scheme not allowed here
// after
minio:
  address: minio:9000
  use-ssl: false
  access-key-id: minioadmin
  secret-access-key: minioadmin

func validateMinioConfig(cfg config.Minio) error {
    if cfg.Address == "" {
        return errors.New("minio address is empty")
    }
    if strings.Contains(cfg.Address, "://") {
        return fmt.Errorf("minio address %q must be host:port without scheme", cfg.Address)
    }
    host, port, err := net.SplitHostPort(cfg.Address)
    if err != nil || host == "" || port == "" {
        return fmt.Errorf("minio address %q is not host:port", cfg.Address)
    }
    if _, err := net.LookupHost(host); err != nil {
        return fmt.Errorf("minio host %q does not resolve: %w", host, err)
    }
    return nil
}

filePath, key, err := minioUploader.UploadFile(ctx, fileHeader)
if err != nil {
    if strings.HasPrefix(err.Error(), "minio client 初始化失败") {
        // configuration/connectivity problem: fail fast, alert ops, do not retry blindly
        return fmt.Errorf("storage unavailable, check minio config/connectivity: %w", err)
    }
    return err
}

When it happens

Trigger: UploadFile called with a misconfigured MinIO endpoint in config (missing scheme handling, malformed host:port, empty endpoint), DNS failure resolving the MinIO host, or invalid TLS options passed to minio.New.

Common situations: minio.address configured as 'http://host:9000' or with a trailing slash instead of plain host:port; typo in hostname; MinIO not yet started when the app boots and receives its first upload; docker-compose service name not resolvable from the app container.

Related errors

• 无可用初始化过程，请检查初始化是否已执行完成
• mssql config invalid
• mysql config invalid
• postgresql config invalid
• sqlite config invalid

AI-assisted analysis of flipped-aurora/gin-vue-admin@3136500ef3 (2026-08-31). Data as JSON: /api/errors/b3004e99a822f8c9. Report an issue: GitHub.