PHP PDO调用SQL Server存储过程出现字符值强制转换错误求助

错误详情 #

调用带输出参数的SQL Server存储过程sp_SYS_AddUser实现用户注册功能时，表单提交后触发PDOException：

SQLSTATE[22018]: [Microsoft][ODBC Driver 17 for SQL Server]Invalid character value for cast specification

报错点为signup.classes.php第33行的PDOStatement->execute()执行步骤，已自行排查参数类型未发现明显问题，附相关代码清单：

• 入口逻辑：signupinc.php
• 模型实现：signup.classes.php
• 控制器实现：signupContr类
• 数据库存储过程：sp_SYS_AddUser定义

排查方向 #

该错误为ODBC驱动在执行阶段无法将传入的参数值转换为存储过程定义的参数类型导致，优先排查以下场景：

1. 参数类型不匹配
   逐一核对存储过程输入参数的类型定义与PHP传入的参数值：
   • int、bit、decimal等数值类型参数是否传入了非数字格式的字符串、空字符串
   • datetime、datetime2等日期类型参数是否传入了不符合SQL Server日期格式的字符串
   • uniqueidentifier类型参数是否传入了不符合GUID规则的字符内容
2. 输出参数绑定错误
   SQL Server存储过程的输出参数需要通过PDO显式指定PDO::PARAM_INPUT_OUTPUT属性及参数长度，错误的绑定方式会将输出参数标记为普通字符串传入，触发类型转换错误，参考绑定逻辑：

   // 示例：绑定int类型输出参数
   $stmt->bindParam(1, $returnCode, PDO::PARAM_INT | PDO::PARAM_INPUT_OUTPUT, 4);
   // 示例：绑定字符串类型输出参数
   $stmt->bindParam(2, $userId, PDO::PARAM_STR | PDO::PARAM_INPUT_OUTPUT, 36);
   

3. 空值处理异常
   存储过程定义为NOT NULL的参数如果接收到PHP传入的null值，PDO默认会将其转换为空字符串，若该参数为非字符串类型（int、bit、datetime等），转换时会触发该错误
4. 参数含不可见字符
   部分从表单提交的参数可能携带全角符号、Unicode控制字符等不可见内容，肉眼无法识别，可在execute()执行前打印所有参数的原始字节内容，确认是否存在异常字符
5. 编码配置错误
   检查PDO连接的PDO::SQLSRV_ATTR_ENCODING配置是否与存储过程参数的字符类型（varchar/nvarchar）匹配，编码不兼容会导致多字节字符被转义为乱码，触发类型转换失败

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