gRPC端口必须填6334，填6333会因协议错配导致“frame too large”错误；gRPC端口填6333会报"frame too large"错误Qdrant 的 HTTP 和 gRPC 是两个完全独立的服务端口，不能混用。Go 客户端默认走 gRPC 协议，必须用 6334；若误填 6333（HTTP 端口），gRPC 库会尝试解析 HTTP 响应为二进制帧，直接触发 "frame

Go 的 context.Context 不自带 Trace ID，需通过 context.WithValue 显式注入；Go 的 context.Context 本身不带 Trace ID，得自己塞进去Go 标准库的 context.Context 是空壳，没有内置 Trace 字段。典型场景：你用 http.Client.Do() 调第三方 API，但没在 req.Header 里塞 trac

避免在 @app.route 里调 db.session.add() 或 requests.post()。别依赖 request.remote_addr 做去重 —— 内网、代理、NAT 下全是同一个 IP别把 session.get('user_id') 当唯一依据 —— 未登录时返回 None，导致日志缺失 user_id 字段cookie 的 visitor_id 要设 httponly=F

更重要的是，它默认禁用用户自定义 JS/CSS 注入（没有类似 WordPress 的 wp_head 钩子）。把真实背景图（比如 /usr/share/phpmyadmin/bg.jpg）先用 ImageMagick 加一层高斯模糊：convert bg.jpg -blur 0x8 bg-blur.jpg在自定义 CSS 中（例如通过 Nginx 的 sub_filter 或反向代理注入），给