新版本sonarqube（8.0+）在linux上必须使用postgresql，禁用mysql；启动失败最常见原因是vm.max_map_count过低或postgresql连接配置错误，需显式指定template template0、scram-sha-256认证及127.0.0.1而非localhost连接。
新版本 SonarQube（8.0+）在 Linux 上无法直接用 MySQL，必须用 PostgreSQL；同时 vm.max_map_count 不够会导致启动失败——这是部署失败最常卡住的两个点。
PostgreSQL 必须先配好，且权限和连接要通
SonarQube 25.x 及主流 LTS 版本（如 10.4、9.9）已彻底弃用 MySQL。PostgreSQL 不只是“能用”，而是硬性依赖：
-
CREATE DATABASE sonarqube WITH ENCODING 'UTF8' TEMPLATE template0;必须显式指定TEMPLATE template0，否则中文字符可能乱码 - 用户密码要用
SCRAM-SHA-256加密（PostgreSQL 10+ 默认），所以pg_hba.conf里对应行得写host sonarqube sonar 127.0.0.1/32 scram-sha-256，不能留md5或trust -
sonar.jdbc.url中的 host 不能写localhost（会走 Unix socket），得写127.0.0.1，否则 SonarQube 启动时连不上
启动失败？先查 vm.max_map_count 和 file-max
日志里只要出现 max virtual memory areas vm.max_map_count [65530] is too low 或 too many open files，就不是 SonarQube 配置问题，是系统限制没调：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 临时生效：
sudo sysctl -w vm.max_map_count=262144和sudo sysctl -w fs.file-max=65536 - 永久生效：往
/etc/sysctl.conf尾部追加这两行，再执行sysctl -p - 别漏掉 ulimit：在
/etc/security/limits.conf加两行：* soft nofile 65536和* hard nofile 65536，否则 systemd 启动的服务读不到
sonar-scanner 扫描命令里 projectKey 和 sources 容易写错
从 SonarQube Web 页面生成的扫描命令看着简单，但两个参数实际很敏感：
-
projectKey必须和 Web 端创建项目时填的完全一致（区分大小写、不可含空格或特殊符号），否则扫完数据进错项目甚至丢弃 -
sources是相对sonar-scanner当前工作目录的路径，不是绝对路径；如果代码在/home/user/myapp，进到该目录再执行sonar-scanner -Dsonar.projectKey=myapp -Dsonar.sources=.才对；写成-Dsonar.sources=/home/user/myapp会静默失败 - Java 项目若用 Maven，优先用
mvn sonar:sonar，它自动读pom.xml里的配置，比手写sonar-scanner命令少出错
Jenkins 流水线里调 sonar-scanner 要注意环境隔离
Jenkins agent 上装了 sonar-scanner，不代表每个 job 都能直接用——尤其当多个 job 并发扫描时：
- 别把
sonar-scanner装在/usr/local下然后全局 PATH，容易被不同 job 的 JDK 版本冲突拖垮；推荐每个 job 单独下载解压，用sh './sonar-scanner/bin/sonar-scanner ...'绝对路径调用 -
sonar.login必须传 token（不是用户名密码），且 token 要在 Jenkins 凭据管理里存为 Secret Text 类型，不能硬编码在 pipeline 脚本里 - 扫描大项目时加
-X参数看详细日志，常见卡在INFO: Load project repositories——多半是网络不通或 token 权限不足
真正麻烦的从来不是“怎么装”，而是 PostgreSQL 认证方式、内核参数、scanner 路径解析这三处细节稍一松懈，就会让整个流程停在某个看似无关的报错上。
