jira在linux上需严格配置java版本（11或17）、独立数据库用户与utf8字符集、反向代理透传x-forwarded头及server.xml匹配参数，否则将导致启动失败、乱码、url错误或高并发异常。
Jira 在 Linux 上不能直接“搭建”成开箱即用的企业级系统——它依赖 Java 运行时、数据库持久化、反向代理与权限隔离，跳过任一环节都可能在升级、备份或并发访问时出问题。
确认 Java 版本是否匹配 Jira 官方要求
Jira 9.x 起仅支持 Java 11 或 Java 17（LTS），不兼容 Java 8 或 Java 21。用 java -version 查看当前版本后，必须核对 https://confluence.atlassian.com/jirakb/supported-platforms-779067577.html 中对应 Jira 小版本的 JDK 列表。
- OpenJDK 推荐使用
temurin-17-jdk（非openjdk-17-jdk-headless，后者缺 JMX 支持，导致 Jira 启动失败） - 若系统默认是 Java 11，但下载的是 Jira 9.4+，需手动修改
atlassian-jira/ bin/setenv.sh中的JAVA_HOME指向 Java 17 路径 -
java -XshowSettings:properties -version 2>&1 | grep java.home可验证实际生效路径，避免软链接未更新导致误判
数据库初始化必须用独立用户 + 显式字符集
PostgreSQL 或 MySQL 都不能用 root 或 postgres 用户直连 Jira；字符集不匹配会导致中文字段乱码、工作流保存失败等静默异常。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- PostgreSQL 示例：
CREATE DATABASE jiradb WITH ENCODING 'UTF8' LC_COLLATE='en_US.UTF-8' LC_CTYPE='en_US.UTF-8' TEMPLATE=template0;<br>CREATE USER jirauser WITH PASSWORD 'strong-pass-2024';<br>GRANT ALL PRIVILEGES ON DATABASE jiradb TO jirauser;
- MySQL 必须指定
CHARACTER SET = utf8mb4 COLLATE = utf8mb4_bin，且禁用STRICT_TRANS_TABLES模式（Jira 的某些 legacy SQL 会触发报错） - Jira 安装向导中填写的数据库用户名密码，必须和上述创建的完全一致；测试连接成功 ≠ 表已建好 —— 真正建表发生在首次启动并完成 setup wizard 后
反向代理必须透传 Host 和 X-Forwarded-* 头
用 Nginx 或 Apache 做前置时，若只配 proxy_pass，Jira 生成的邮件链接、OAuth 回调地址、附件预览 URL 全部指向 http://localhost:8080，用户无法访问。
- Nginx 关键配置段：
location / {<br> proxy_pass http://127.0.0.1:8080;<br> proxy_set_header Host $host;<br> proxy_set_header X-Real-IP $remote_addr;<br> proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<br> proxy_set_header X-Forwarded-Proto $scheme;<br>} - 同时必须在
atlassian-jira/conf/server.xml里修改 Connector：
添加proxyName="jira.example.com" proxyPort="443" scheme="https" secure="true"（端口与协议按实际 HTTPS 配置调整） - 改完重启 Jira，再进
Settings > System > General Configuration > Base URL，确保这里显示的是带 https 的完整域名，否则后续集成 Confluence 或 Bitbucket 会签名失败
启动失败常见日志线索与定位方式
不要只盯着 catalina.out 最后几行；Jira 启动是分阶段的，关键错误藏在 atlassian-jira/logs/atlassian-jira.log 中，且往往出现在 “Starting Spring root WebApplicationContext” 之前。
- 出现
ERROR [o.a.c.c.C.[.[.[.[jira]]] Exception starting filter [seraph-filter]：大概率是数据库连接参数错（如 URL 写成jdbc:postgresql://localhost/jiradb却没加?ssl=false）或用户无权限 - 卡在
INFO [c.a.j.config.database.SystemDatabaseConfigurationLoader] Reading database configuration from /var/atlassian/application-data/jira/dbconfig.xml后无下文：检查dbconfig.xml文件权限是否为 Jira 进程用户可读（非 root 创建后忘了chown -R jira:jira） -
Caused by: java.lang.OutOfMemoryError: Metaspace：不是堆内存不够，而是setenv.sh中漏设JVM_SUPPORT_RECOMMENDED_ARGS="-XX:MaxMetaspaceSize=512m"
真正难的不是跑起来，而是让 Jira 在 200+ 用户、50+ 并发编辑、每周自动备份 + 插件热更时不掉链子——这些全取决于数据库连接池设置、server.xml 中 acceptCount/maxThreads 匹配硬件、以及 log4j2.xml 是否关闭了 DEBUG 日志输出到磁盘。
