加密数据导入前必须确认密钥、算法、填充方式和编码格式一致，否则解密失败；解密后需校验数据完整性并清洗字段；批量插入须用预处理语句防注入，并注意MySQL长度限制与包大小。
加密数据导入前必须确认密钥和算法一致
PHP 导入班级通信录时如果数据是加密的，解密失败往往不是代码写错了，而是密钥、算法、填充方式或编码格式对不上。比如导出方用 AES-128-CBC + PKCS7 填充 + Base64 编码 + 固定 16 字节 IV，而导入方用了 AES-256-ECB 或直接拿 raw 密文当 Base64 解，就会报 openssl_decrypt(): Failed to decrypt data 或返回空字符串。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先向数据提供方索要明确的加密参数：算法（如
AES-128-CBC）、密钥长度与来源（是否hash_hmac('sha256', $password, $salt)衍生？）、IV（是否固定/随文传输）、填充方式（PKCS7 还是 ZeroPadding）、编码（Base64 还是 hex） - 用
openssl_get_cipher_methods()检查当前 PHP 版本是否支持该算法（例如旧版不支持AES-192-GCM） - 若 IV 随密文一起传来（常见于前 16 字节），需用
substr($encrypted, 0, 16)截取并传给openssl_decrypt()的$iv参数
解密后解析 JSON 或 CSV 前要校验数据完整性
解密成功不等于数据可用。班级通信录常以 JSON 或 CSV 格式加密打包，解密后若直接 json_decode() 或 fgetcsv()，遇到非法字符、BOM 头、字段缺失或结构错乱会静默失败或插入脏数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 解密后先用
trim()去首尾空白，再用mb_detect_encoding()确认编码（避免 UTF-8 BOM 导致json_last_error()返回JSON_ERROR_UTF8） - JSON 场景：检查
json_validate($data)（PHP 8.3+）或json_decode($data, true) !== null && json_last_error() === JSON_ERROR_NONE - CSV 场景：用
str_getcsv()测试首行字段数是否统一；若含中文，确保fopen($file, 'rb')后用stream_filter_append($fp, 'convert.iconv.UTF-8/GB18030')（依实际源编码调整）
批量插入通信录数据时注意 MySQL 字段长度和 SQL 注入防护
解密解析后的数组若直接拼 SQL 插入，容易触发 MySQL Data too long for column（如手机号存 varchar(11) 却插入带空格的“138 1234 5678”），或被恶意姓名字段（如 O'Reilly）破坏语句结构。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 插入前对每条记录做字段清洗：
trim()去空格、preg_replace('/\D/', '', $phone)提纯手机号、mb_substr($name, 0, 50)截断超长姓名（而非静默丢弃） - 必须用 PDO 预处理：
$stmt = $pdo->prepare("INSERT INTO students (name, phone, class) VALUES (?, ?, ?)"); $stmt->execute([$name, $phone, $class]); - 若需批量插入百条以上，改用
INSERT INTO ... VALUES (...), (...), (...)多值语法，但单次不超过 1000 行，避免 max_allowed_packet 超限
调试时优先 dump 解密中间态而非最终结果
导入失败时，很多人只看 var_dump($decoded_data)，但真正卡点往往在更早环节：比如 Base64 解码后是乱码（说明加密参数错），或解密后是空字符串（说明密钥/IV 错或密文损坏）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 分步打点：
echo "Base64 decoded len: " . strlen(base64_decode($raw));→echo "Decrypted hex: " . bin2hex($decrypted);→echo "UTF-8 clean: " . mb_convert_encoding($decrypted, 'UTF-8', 'auto'); - 把解密后原始字节流写入临时文件：
file_put_contents('/tmp/debug.bin', $decrypted);，再用file /tmp/debug.bin或 VS Code 以 HEX 查看器打开，确认是否为可读文本 - 如果通信录加密由前端 JS 完成（如 CryptoJS），注意 PHP 的 OpenSSL 默认使用 PKCS7 填充，而 CryptoJS 默认是 Pkcs7，但部分版本需显式指定
{padding: CryptoJS.pad.Pkcs7}，否则填充不兼容
密钥硬编码、IV 复用、未验证解密后数据签名——这些细节在小范围测试时不会暴露，一旦换环境或数据量上升就突然崩，比逻辑错误更难定位。
