gRPC端口必须填6334，填6333会因协议错配导致“frame too large”错误；CreateCollection需显式指定VectorsConfig维度；Search过滤须用qdrant.Filter结构体而非map；Upsert推荐用于批量写入，单次100–500条为宜。gRPC端口填6333会报"frame too large"错误Qdrant 的 HTTP 和 gRPC 是两个完全独立的服务端口，不能混用。Go 客户端默认走 gRPC 协议，必须用 6334；若误填 6333（HTTP 端口），gRPC 库会尝试解析 HTTP 响应为二进制帧，直接触发 "frame too large" 或 "unknown server compatibility" 类错误。6333：仅限 curl / REST API / Dashboard 访问，Go 客户端连不上6334：gRPC 专用端口，客户端初始化时必须指定启动容器时务必暴露两个端口：-p 6333:6333 -p 6334:6334如遇版本兼容警告，可临时加配置 SkipCompatibilityCheck: true，但生产环境建议客户端与 Qdrant 版本对齐（如都用 v1.10.x）CreateCollection必须显式指定VectorsConfig维度Qdrant 不允许“动态推断”向量维度，创建集合时若漏传或传错 VectorsConfig，后续所有 Upsert 都会失败，错误提示模糊（常为 invalid vector dimension 或空 panic）。维度值必须和你实际插入的向量长度严格一致，比如 OpenAI text-embedding-3-small 输出是 1536 维，就得写 qdrant.NewVectorsConfig(1536)不支持多向量字段自动识别，如有多个向量字段，需用 VectorStruct 显式定义集合创建后无法修改维度，删库重建是唯一办法Search查询时过滤 payload 要用Filter结构体，不是 map很多开发者习惯把过滤条件写成 map[string]interface{} 传进去，结果查不到数据也不报错——因为 Qdrant Go 客户端的 SearchPoints.Filter 字段类型是 *qdrant.Filter，底层是 Protocol Buffer 结构，不能直传原始 map。 Vozo Vozo是一款强大的AI视频编辑工具，可以帮助用户轻松重写、配音和编辑视频。