`SQLiteEntityStore` incorrectly suggests `pip install sqlite3`

快速结论：该报错说明 Python 标准库的 sqlite3 模块不可用，通常发生在 Python 编译时未启用 SQLite 支持或系统缺少 SQLite 库的环境中。优先排查方向不是 pip install sqlite3，因为该命令无效——请检查 Python 发行版或系统级的 SQLite 安装。

适用环境：langchain-classic 1.0.8（其 SQLiteEntityStore 模块触发报错）；问题在 Python 3.14.6、macOS 26.6.2 arm64 环境中被报告。

最快修复方案：暂无确认的一步修复方案。正确的解决方向是重新安装/重新编译带 SQLite 支持的 Python，或通过系统包管理器安装 OS 层面的 SQLite 开发库（例如 libsqlite3-dev）。这是 Issue 中提出的建议方向，尚未有社区成员实际验证过的完整修复步骤。

注意事项：PyPI 不允许注册与标准库同名的包，因此 pip install sqlite3 无法修复此问题，只会误导用户。同时，该报错信息来自 langchain_classic 包 1.0.8 的 memory/entity.py（约第 390-394 行），更新 LangChain 版本并不能解决此报错。

问题场景

在 langchain-classic 1.0.8 环境中直接实例化 SQLiteEntityStore 时触发。用户通过模拟 Python 环境缺少 sqlite3 标准库模块（monkey-patch builtins.__import__），复现了该异常的抛出路径。

报错原文

Could not import sqlite3 python package. Please install it with `pip install sqlite3`.

原因分析

该报错是 SQLiteEntityStore 内部对 sqlite3 标准库模块的导入失败处理逻辑导致的。问题本质是 sqlite3 是 CPython 的可选标准库模块（编译安装 Python 时可通过 --enable-loadable-sqlite-extensions 或系统库链接启用），并非可独立安装的 PyPI 包。PyPI 出于安全考虑不允许注册与标准库模块同名的项目，因此报错中建议的 pip install sqlite3 是无效指令，无法修复缺失的 SQLite 支持。该语言层面的误导性错误信息，属于 langchain-classic 的错误提示缺陷。

环境排查

检查 Python 版本：在终端执行 python3 --version，确认 Python 主版本（Issue 报告使用 3.14.6）。
验证 sqlite3 模块是否可用：执行 python3 -c "import sqlite3; print(sqlite3.sqlite_version)"，若报 ModuleNotFoundError 则说明 Python 缺少 SQLite 支持。
确认操作系统类型与包管理器（如 macOS 的 Homebrew、Debian/Ubuntu 的 apt、Windows 的 Python 安装器），用于判断系统 SQLite 库是否存在。
核对 langchain-classic 包版本是否为 1.0.8（报错源头在该版本中确认存在）。

解决步骤

确认根因：运行 python3 -c "import sqlite3"，若抛 ModuleNotFoundError，则确认 Python 未编译 SQLite 支持（而非缺失第三方包）。
修复 Python 或系统 SQLite（可优先尝试）：根据 Issue 讨论建议，选择以下方式之一：重新安装/重新编译 Python 并启用 SQLite 支持；或通过操作系统包管理器安装 SQLite 开发库（例如 Debian/Ubuntu 下安装 libsqlite3-dev 后重装 Python）。请根据自身系统选择正确方案，本步骤尚未有用户在 Issue 中提供逐条验证记录。
若使用 pyenv 或自编译 Python：检查编译参数是否包含 SQLite 支持（例如 --enable-loadable-sqlite-extensions），缺失时需重新编译安装。
暂时绕过（如果只需要实体记忆功能的替代方案）：可以考虑不使用 SQLiteEntityStore，改用其他记忆存储实现（例如基于内存的 ConversationBufferMemory 或其他 KeyValueStore）。这是 Issue 之外的推测，请酌情评估。

验证方法

完成上述修复后，重新运行 python3 -c "import sqlite3; print(sqlite3.sqlite_version)"，确认模块可正常导入且能输出 SQLite 版本号；随后再次实例化 SQLiteEntityStore()，确认不再抛出 ImportError。