Django多SQLite数据库配置下执行dbshell提示sqlite3未安装问题

我在Django项目中配置了两个SQLite数据库，一个为默认库，另一个为customer_data库，同时编写了routers.py路由类如下：

class CustomerRouter: 
    """ 控制auth应用模型所有数据库操作的路由 """
    def db_for_read(self, model, **hints): 
        """ 尝试将auth模型的读操作路由到auth_db """
        if model._meta.app_label == 'customer': 
            return 'customer_data'
        return None

但执行django-admin dbshell命令时出现错误：CommandError: You appear not to have the 'sqlite3' program installed or on your path，现寻求该问题的解决方案。

首先明确一点：这个错误和你配置的多数据库路由（CustomerRouter）没有任何关联，核心问题是你的操作系统找不到SQLite的命令行客户端工具sqlite3——Django的dbshell命令会直接调用对应数据库的官方客户端程序，SQLite对应的就是sqlite3，所以必须确保这个工具能在终端/命令提示符中直接运行。

下面是不同操作系统的具体解决方案：

1. Windows系统 #

Windows 10/11默认没有预装sqlite3，需要手动配置：

• 下载SQLite预编译二进制包（选择适配你系统位数的版本）
• 解压后得到sqlite3.exe，将其放到系统PATH已包含的文件夹（比如C:\Windows\System32），或者把sqlite3.exe所在的文件夹添加到系统环境变量PATH中
• 验证：打开新的命令提示符，输入sqlite3，如果能进入SQLite的交互界面，说明配置成功

2. macOS系统 #

macOS通常预装了sqlite3，如果报错，大概率是命令行工具缺失或PATH异常：

• 打开终端，执行xcode-select --install，安装Xcode命令行工具（这会自动修复/安装sqlite3）
• 验证：终端输入sqlite3，确认能进入交互界面

3. Linux系统 #

Debian/Ubuntu系列 #

执行以下命令安装sqlite3：

sudo apt update
sudo apt install sqlite3

验证：输入sqlite3 --version，能显示版本号即为安装成功

CentOS/RHEL系列 #

执行以下命令安装：

sudo yum install sqlite

验证：同样用sqlite3 --version确认安装状态

额外排查步骤 #

如果已经安装sqlite3但仍报错，需要检查：

• 直接在终端/命令提示符输入sqlite3，看是否能正常运行——如果不能，说明sqlite3所在路径未加入系统PATH
• 找到sqlite3的安装路径：Linux用which sqlite3，Windows用where sqlite3
• 将该路径添加到系统PATH环境变量，关闭并重新打开终端/命令提示符后生效

内容的提问来源于stack exchange，提问作者Khant Htet Naing