通过PHP调用Python脚本处理考勤数据时遇schema参数错误

这个错误本质是调用函数/类的初始化方法时，同一个参数同时通过位置参数和关键字参数传递了两次，结合你命令行运行正常、浏览器调用异常的场景，按以下步骤排查：

1. 定位错误发生的具体代码行 #

在Python脚本的关键逻辑（比如数据库连接、SQL查询初始化部分）添加异常捕获，打印完整的错误堆栈：

import traceback

try:
    # 你的数据库操作、SQL查询初始化代码
    # ...
except Exception as e:
    print(f"Error details: {str(e)}")
    print(traceback.format_exc())
    # 写入日志文件留存记录
    with open('/var/log/attendance_script_error.log', 'a') as f:
        f.write(f"Error: {str(e)}\n{traceback.format_exc()}\n---\n")

通过堆栈信息能直接看到是哪个类/函数的__init__方法触发了错误，精准定位问题点。

2. 排查数据库代码的参数重复传递 #

最常见的触发场景是数据库连接相关代码中重复指定了schema参数，比如：

• 使用SQLAlchemy时，数据库URL里已经通过options=-c search_path=xxx指定了schema，同时又在create_engine或ORM模型中额外传递了schema=xxx参数
• 自定义的数据库操作类中，初始化方法的参数定义和调用时的传参方式冲突，比如位置参数和关键字参数混用导致重复

举个错误示例：

# 错误：URL中已指定schema，又额外传schema参数
engine = create_engine(
    'postgresql://user:pass@localhost/attendance?options=-c search_path=attendance_schema',
    schema='attendance_schema'  # 这里重复传递了schema
)

解决方式：去掉其中一个重复的schema指定，统一用一种方式配置。

3. 验证Python运行环境一致性 #

Raspberry Pi上可能存在多个Python版本（比如Python2和Python3），命令行运行的版本和PHP调用的版本可能不一致，导致依赖库的参数定义不同：

• 在命令行执行which python或which python3，拿到当前正常运行的Python路径
• 修改PHP脚本中调用Python的命令，指定完整路径，比如：

// 之前的调用可能是
// exec("python /path/to/script.py $date1 $date2", $output, $return_var);
// 修改为指定版本
exec("/usr/bin/python3 /path/to/script.py $date1 $date2", $output, $return_var);

4. 检查环境变量差异 #

命令行用户和PHP运行用户（通常是www-data）的环境变量可能不同，如果你的Python脚本依赖环境变量加载配置，可能导致某些参数被重复添加：

• 在Python脚本开头打印当前环境变量，对比命令行和浏览器调用时的差异：

import os
print("Environment variables:", os.environ)

如果发现某个环境变量在PHP运行时存在，导致代码额外传递了schema参数，调整逻辑避免重复。

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