Docker环境下SonarQube Python扫描异常挂起问题求助

我之前碰到过几乎一模一样的问题，当时折腾了好一阵才解决，给你几个排查方向试试：

1. 检查Python版本与SonarQube插件的兼容性 #

SonarQube 7.1对应的默认Python插件只兼容Python 2.7、3.4-3.6。如果你的项目使用的是更高版本的Python（比如3.7+），Squid Sensor在解析语法时很容易卡住。

你可以先在扫描器容器里执行python --version确认版本，要是版本不匹配，要么换对应Python版本的基础镜像构建扫描器，要么考虑升级SonarQube（当然如果不想动服务器版本，优先调整Python版本更直接）。

2. 清理扫描器缓存并确认版本匹配 #

SonarQube 7.1官方推荐的扫描器版本是3.0.x到3.2.x，你试过的3.0.3.778和3.1.0.1141都在范围内，但旧缓存可能残留了错误数据导致卡住。

在扫描前先清除扫描器的缓存目录，执行命令：

rm -rf ~/.sonar/cache && sonar-scanner

3. 排除不必要的文件/目录 #

如果你的Python项目里有大量第三方依赖（比如venv虚拟环境目录）、编译缓存（__pycache__、.pyc文件），或者存在单文件行数过万的超大Python脚本，都会让Squid Sensor的解析过程超时卡住。

在你的sonar-project.properties里添加排除规则：

sonar.exclusions=**/venv/**,**/__pycache__/**,**/*.pyc,**/your-huge-file.py

先排除这些内容后再测试扫描，看是否能正常完成。

4. 调整Docker容器的资源配额 #

SonarQube或者扫描器容器的内存、CPU资源不足，也会导致解析过程停滞。

给SonarQube容器增加内存限制：

docker run -d --name sonarqube -p 9000:9000 -e SONAR_JAVA_OPTS="-Xmx2048m" sonarqube:latest

启动扫描器容器时也加上资源参数：

docker run --memory=2g your-scanner-image sonar-scanner

5. 查看SonarQube服务器日志定位问题 #

有时候卡住的根源在服务器端，你可以查看SonarQube容器的日志：

docker logs sonarqube

重点找Python插件相关的报错（比如内存溢出、语法解析错误），这些日志能帮你精准定位问题。

我当时的情况是项目里有个1.2万行的超大Python文件，加上扫描器缓存残留了旧数据，清除缓存+排除大文件后就正常完成扫描了。你可以逐个尝试这些方法，应该能解决问题。

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