必须在postgresql中启用pgvector扩展并正确配置dify，否则知识库上传和rag检索将失败；需确认版本≥14、安装对应pgvector、创建extension、建表及hnsw索引，并配置database_url为超级用户。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中使用现有PostgreSQL实例存储向量数据，必须先在该数据库中启用pgvector扩展，并确保Dify服务能正确识别并写入向量表——否则知识库上传、RAG检索将直接失败。
确认 PostgreSQL 实例已就绪
登录目标 PostgreSQL 服务器（非 Docker 内置数据库），用 postgres 超级用户执行：SELECT version(); 确认版本 ≥ 14（pgvector v0.5+ 要求）；同时检查 SHOW data_directory; 输出路径是否可写，后续编译安装 pgvector 时需匹配该实例的 pg_config。
这一步不能跳过：若用的是宝塔或一键脚本安装的 PostgreSQL，【/usr/lib/postgresql/*/lib/pgxs/src/makefiles/pgxs.mk】常缺失，会导致 make install 失败。
安装 pgvector 扩展
方法一：Docker 环境下直接换镜像（推荐开发）
停掉当前 PostgreSQL 容器，改用官方 pgvector 镜像启动：docker run -d --name dify-pg -e POSTGRES_PASSWORD=knosphere_password -e POSTGRES_DB=knosphere -p 5432:5432 -v pgdata:/var/lib/postgresql/data pgvector/pgvector:pg17。该镜像已预装 vector 扩展，无需手动 CREATE EXTENSION。
方法二：Linux 服务器原地启用（生产常用）
① 下载与 PostgreSQL 版本严格对应的 pgvector 源码（例如 PostgreSQL 16 → pgvector v0.7.0）；
② 进入源码目录，执行 make PG_CONFIG=/usr/lib/postgresql/16/bin/pg_config（路径必须与 which pg_config 一致）；
③ sudo make install；
④ 切换到目标数据库（如 knosphere），以 postgres 用户执行：CREATE EXTENSION IF NOT EXISTS vector;；
⑤ 验证：SELECT * FROM pg_extension WHERE extname = 'vector'; 返回一行即成功。
配置 Dify 使用该 PostgreSQL 向量库
编辑 Dify 的 docker-compose.yml，定位到 dify-api 服务的 environment 区块，添加或修改以下三项：
DATABASE_URL=postgresql://admin:knosphere_password@host.docker.internal:5432/knosphere（注意：Windows/macOS 用 host.docker.internal；Linux 用宿主机真实 IP）
VECTOR_STORE=pgvector
PGVECTOR_COLLECTION_NAME=document_chunk（该表名必须与后续建表语句完全一致）
⚠️ 关键点：【DATABASE_URL 中的用户名必须是超级用户或已获 pgvector 权限的用户】，普通用户无法创建向量索引，Dify 启动时会报 “permission denied to create extension” 并退出。
初始化向量表结构
连接到 knosphere 数据库，执行建表语句：
CREATE TABLE IF NOT EXISTS document_chunk (id VARCHAR(64) PRIMARY KEY,document_id VARCHAR(64),chunk TEXT,chunk_index INTEGER,vector vector(1536));
为 vector 列创建 HNSW 索引提升检索速度：CREATE INDEX ON document_chunk USING hnsw (vector vector_cosine_ops) WITH (m = 16, ef_construction = 64);
这一步必须在 Dify 第一次启动前完成。如果跳过，Dify-worker 在解析知识库文档时会因缺少 vector 列而抛出 psycopg2.errors.UndefinedColumn 异常，任务卡死。
