SQLite log函数在PyCharm查询控制台与Python环境结果不一致的原因及解决方法

在使用SQLite时，发现log(10)的返回结果在不同环境中存在差异：

• Python环境（sqlite3模块）：返回近似1.0的结果

  >>> from sqlite3 import connect
  >>> cur = connect("data/db.sqlite3").cursor()
  >>> print(cur.execute("select log(10);").fetchall())
  [(0.9999999999999999,)]
  

• PyCharm查询控制台：返回自然对数结果

  +-----------------+
  |log(10)          |
  +-----------------+
  |2.302585092994046|
  +-----------------+
  

根据SQLite官方文档说明，Python中执行log(x)被解析为以10为底的对数：

Return the base-10 logarithm for X. Or, for the two-argument version, return the base-B logarithm of X.

请问出现这种情况的原因是什么？如何确保查询在所有环境中结果一致？

核心差异来自Python的sqlite3模块对SQLite原生函数的自定义覆盖：

• SQLite原生的单参数log(X)函数默认返回自然对数（ln(X)），PyCharm查询控制台直接调用SQLite原生实现，因此返回该结果。
• Python的sqlite3模块会自动注册一个自定义的log函数：当仅传入一个参数时，默认使用10作为底数计算对数；传入两个参数时，才按log(base, X)的逻辑执行。这就导致Python环境中log(10)返回以10为底的对数结果（近似1.0）。

为了在所有环境中得到一致结果，避免依赖不同环境对log函数的隐式定义，建议使用SQLite原生支持的明确函数名：

• 需要以10为底的对数：使用log10(X)

  select log10(10); -- 所有环境都会返回1.0（或近似值）
  

• 需要自然对数：使用ln(X)

  select ln(10); -- 所有环境都会返回2.302585092994046
  

如果需要自定义底数的对数，可以使用log(X, base)的双参数形式（SQLite原生和Python的sqlite3都支持该行为，结果完全一致）：

select log(100, 10); -- 返回2.0，所有环境结果统一

如果必须在Python中使用原生SQLite的log行为，可以通过sqlite3.Connection.create_function方法覆盖默认的自定义函数，但这种做法会增加环境耦合，不推荐。使用明确的函数名是最可靠的跨环境方案。

内容的提问来源于stack exchange，提问作者Mirac7