导入pymysql导致Python-CGI崩溃（500错误）的原因排查

问题描述 #

现有script1.py代码如下：

import cgi
import cgitb
print("Content-type:text/html\r\n\r\n")
print("hello")

该脚本运行正常，可输出'hello'；script2.py代码为：

import cgi
import cgitb
import pymysql
print("Content-type:text/html\r\n\r\n")
print("hello")

但执行时返回500错误。已知pymysql已安装，在Python交互shell中可正常导入且无异常，两个文件权限一致，请问为何script2.py会出现该问题？

可能的原因及解决方案 #

这问题在CGI场景里太常见了，核心原因基本都是Web服务器的运行环境和你本地测试的Python环境不匹配，给你逐个排查：

1. Python解释器路径不一致
   你在终端里用的Python和Web服务器调用CGI用的可能不是同一个版本/路径！比如你手动把pymysql装到了~/anaconda3/bin/python，但Apache/Nginx的CGI默认用系统自带的/usr/bin/python3，这个环境里根本没装pymysql。

   • 排查方法：在两个脚本里都加上这段代码，运行后看输出的路径是否一致：

     import sys
     print("Content-type:text/html\r\n\r\n")
     print(sys.executable)
     

   • 解决：要么给服务器用的Python安装pymysql，要么在脚本开头指定正确的解释器路径（比如#!/usr/bin/env python3.10，换成你装了pymysql的那个版本）。

2. 依赖库的权限问题
   脚本文件权限一致不代表pymysql所在的目录权限没问题！如果你用自己的用户（比如sergio）或者root装的pymysql，库文件所在的目录权限可能是700，而Web服务器的运行用户（比如www-data、nginx）没有读取权限，自然导入失败。

   • 排查：用ls -l $(python -c "import pymysql; print(pymysql.__file__)")看文件权限，确认Web用户能读。
   • 解决：给库目录添加其他用户的读取权限，比如chmod -R o+rX /path/to/pymysql/directory。

3. 没开启cgitb的错误追踪
   你导入了cgitb但没启用它！CGI脚本出错时默认只返回500，看不到具体错误信息，等于瞎猜。赶紧在script2.py的开头加上：

   import cgitb
   cgitb.enable()  # 这行必须加，才能在浏览器里看到详细报错
   

   开启后再运行脚本，浏览器里会显示具体的错误（比如ModuleNotFoundError: No module named 'pymysql'或者权限错误），直接定位问题根源。

4. 安全模块限制（SELinux/AppArmor）
   如果你的服务器开了SELinux（比如CentOS、RHEL系列）或者AppArmor（Ubuntu、Debian），可能会阻止Web进程访问Python库目录。

   • 排查：临时关闭SELinux试试（sudo setenforce 0），如果脚本正常运行了，就是SELinux的锅。
   • 解决：给pymysql所在的目录添加正确的SELinux上下文，比如sudo chcon -R system_u:object_r:httpd_sys_content_t:s0 /path/to/python/site-packages/pymysql。

5. 依赖缺失（少见但可能）
   虽然你在终端里能导入pymysql，但Web环境可能缺少它依赖的底层库（比如某些加密相关的系统库）。不过这种情况开启cgitb后会直接显示具体的缺失项，照着安装就行。

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