1. 环境准备从零开始的UOS系统认知如果你之前一直在Windows或者主流的Ubuntu、CentOS上做开发第一次拿到一台预装了统信UOS的机器可能会有点懵。别慌我刚开始接触的时候也这样感觉界面是挺友好但一打开终端想干点“正事”的时候就发现有些习惯得改改。其实UOS本质上是一个基于Linux内核的国产操作系统它的底层逻辑和Debian、Ubuntu这些发行版是相通的。所以我们很多在Linux上的经验在这里依然适用只不过在软件源、包管理工具和一些系统路径上会有一些“中国特色”的调整。首先你得知道怎么获取软件。在Windows上我们习惯去官网下载.exe或.msi安装包在UOS上最推荐的方式是使用系统自带的“应用商店”或者apt命令。应用商店图形化操作对新手很友好但有时候我们需要的开发工具版本比较新或者比较特定商店里可能没有。这时候就得靠终端的apt命令了这也是我们后续操作的核心。你需要确保你的系统已经正确配置了软件源这样下载和更新软件才会又快又稳。你可以打开“控制中心”-“更新设置”里查看通常UOS会默认配置好官方和国内镜像源以保证访问速度。另一个重要的认知是权限管理。UOS默认的用户并不是root超级管理员这其实是个好习惯提高了系统安全性。但我们在部署环境时经常需要安装软件到系统目录、修改系统配置文件这些操作都需要sudo权限。简单理解sudo就是在你的命令前加的一个“临时通行证”输入当前用户密码后就能以管理员身份执行这条命令了。所以你会看到我后面很多命令都带着sudo开头。记住在UOS下干活sudo是你的好朋友但也要谨慎使用别乱删系统文件。最后建议你先熟悉一下UOS的文件系统结构。特别是/usr用户安装的软件、/etc系统配置文件、/opt可选的应用软件包我们常把Tomcat、JDK手动安装在这里以及你的家目录/home/你的用户名。了解这些当后面配置环境变量、寻找安装路径时你就能心中有数不会迷路。好了基础认知建立后我们就开始动手第一步就是把Java的“发动机”——JDK给装上。2. JDK安装与环境变量配置打好Java地基在UOS上安装JDK你有好几个选择我挨个给你分析一下说说各自的优缺点你可以根据项目实际情况来选。第一种通过应用商店或apt安装OpenJDK。这是最省心的方法特别适合新手或者对JDK版本要求不苛刻的项目。UOS的软件源里通常包含了OpenJDK的多个版本。你只需要打开终端执行类似下面的命令sudo apt update sudo apt install openjdk-11-jdk执行sudo apt update是更新本地软件包索引这很重要能确保你安装的是最新可用版本。然后install后面跟的包名openjdk-11-jdk表示安装JDK 11包含开发工具如果只需要运行环境可以安装openjdk-11-jre。安装完成后系统通常会自动配置好一个可用的Java环境。你可以用java -version和javac -version来验证。这种方法优点是自动化程度高依赖关系处理得好缺点是版本可能受软件源限制比如你想用最新的JDK 17或者特定的JDK 8u322源里可能没有。第二种手动下载Oracle JDK或OpenJDK压缩包进行安装。这是更灵活、更推荐给专业开发者的方式。你可以从Oracle官网需账号或者更开放的Adoptium原AdoptOpenJDK等网站下载对应架构通常是x64的.tar.gz压缩包。比如我习惯把JDK安装在/opt目录下# 假设下载的压缩包叫 jdk-11.0.15_linux-x64_bin.tar.gz sudo tar -xzf jdk-11.0.15_linux-x64_bin.tar.gz -C /opt解压后/opt目录下会有一个类似jdk-11.0.15的文件夹。接下来就是关键步骤配置环境变量。环境变量就像是系统的“通讯录”告诉系统当你在终端输入java命令时应该去哪个目录找这个程序。我们不建议直接修改系统级的配置文件如/etc/profile以免影响其他用户。更好的做法是修改当前用户的家目录下的.bashrc文件如果你用的是Bash shell。用文本编辑器如vim或nano打开它vim ~/.bashrc在文件末尾添加以下几行export JAVA_HOME/opt/jdk-11.0.15 # 这里务必替换成你的实际JDK解压路径 export PATH$JAVA_HOME/bin:$PATH export CLASSPATH.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar第一行JAVA_HOME指向你的JDK安装根目录很多Java工具如Maven、Tomcat会依赖这个变量。第二行PATH是把JDK的bin目录添加到系统路径的最前面$PATH代表原有的路径这样系统就能优先找到我们安装的Java命令。第三行CLASSPATH是告诉Java运行时去哪里找类库.代表当前目录。保存退出后执行source ~/.bashrc让配置立即生效或者干脆新开一个终端窗口。再次运行java -version如果显示了你安装的版本信息恭喜你JDK地基就打牢了。这里有个我踩过的坑路径一定要写对尤其是JAVA_HOME多一个少一个斜杠都可能导致失败。可以用ls /opt/jdk-11.0.15/bin/java这样的命令先确认一下java可执行文件的确切存在。3. Tomcat部署让Web应用跑起来JDK准备好之后我们就要搭建Web服务器了。在Java世界里Tomcat依然是轻量级应用的首选它在UOS上的部署也非常简单。和JDK类似你同样有两种主流安装方式。通过apt安装Tomcat。执行sudo apt install tomcat9以Tomcat 9为例系统会自动完成安装、创建服务用户和基本的服务配置。安装后Tomcat的核心文件会分散在几个地方配置文件在/etc/tomcat9web应用默认部署目录在/var/lib/tomcat9/webapps/日志在/var/log/tomcat9/。你可以用sudo systemctl start tomcat9来启动用sudo systemctl enable tomcat9设置开机自启。这种方式适合快速搭建一个标准环境但如果你想自定义安装路径、同时运行多个Tomcat实例或者使用特定版本就不太方便了。手动下载并解压Tomcat。这是我更常用的方式自由度更高。我们去Apache Tomcat官网或者国内镜像站比如清华镜像下载所需的.tar.gz包。我习惯也把它放到/opt目录下wget https://mirrors.tuna.tsinghua.edu.cn/apache/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz sudo tar -xzf apache-tomcat-9.0.85.tar.gz -C /opt解压后/opt/apache-tomcat-9.0.85就是我们的Tomcat根目录了。进去看看有几个关键文件夹你需要熟悉bin/存放启动、关闭等脚本文件。startup.sh和shutdown.sh就是用来控制Tomcat的。conf/配置文件的大本营特别是server.xml主配置、web.xml全局应用配置和tomcat-users.xml用户管理。logs/所有日志文件都在这里排查问题第一站。webapps/这就是我们放Web应用WAR包或解压后的文件夹的地方。work/Tomcat运行时生成的临时文件比如JSP编译后的Servlet类。接下来我们需要解决权限问题。默认解压的文件所有者可能是root。如果我们用非root用户启动Tomcat这是安全最佳实践可能会遇到无法写入日志、无法部署应用等问题。所以我通常会创建一个专门的用户来运行Tomcat并更改目录所有者sudo groupadd tomcat sudo useradd -s /bin/false -g tomcat -d /opt/apache-tomcat-9.0.85 tomcat sudo chown -R tomcat:tomcat /opt/apache-tomcat-9.0.85 sudo chmod -R ux /opt/apache-tomcat-9.0.85/bin/*.sh第一、二行创建了一个不能登录系统的tomcat用户和组。第三行将Tomcat目录的所有权赋予这个用户。第四行确保所有的.sh脚本对所有者u有执行x权限。现在切换到tomcat用户来启动试试需要root权限切换用户sudo -u tomcat /opt/apache-tomcat-9.0.85/bin/startup.sh打开浏览器访问http://你的服务器IP:8080应该能看到那只著名的“汤姆猫”欢迎页面了。如果看不到别急大概率是防火墙问题。UOS可能默认开启了防火墙并阻止了8080端口。你需要放行这个端口sudo ufw allow 8080/tcp # 如果使用ufw # 或者如果你用的是firewalld sudo firewall-cmd --permanent --add-port8080/tcp sudo firewall-cmd --reload4. 项目打包与部署实战环境都齐活了现在轮到我们的主角——Java Web项目上场了。假设你已经在本地用IDE比如IntelliJ IDEA或Eclipse开发调试好了项目并且使用Maven或Gradle进行构建。第一步打包。在项目根目录包含pom.xml或build.gradle的目录下运行打包命令。对于Maven项目最常用的是mvn clean package -DskipTests这个命令会先清理旧的构建产物clean然后跳过测试-DskipTests为了加快打包速度上线前建议跑通测试执行打包package。顺利的话会在target目录下生成一个.war文件比如my-awesome-app.war。这就是我们即将部署到Tomcat的“压缩包”里面包含了编译后的类文件、依赖库、静态资源以及配置描述文件。第二步部署。部署的本质就是把这个WAR文件放到Tomcat能发现并自动解压运行的地方。最简单粗暴的方法就是直接复制到Tomcat的webapps/目录下cp target/my-awesome-app.war /opt/apache-tomcat-9.0.85/webapps/然后启动或重启Tomcat。Tomcat的Host管理器会监控webapps目录一旦发现新的WAR文件就会自动将其解压成一个同名的文件夹例如my-awesome-app/并加载这个应用。访问地址就是http://服务器IP:8080/my-awesome-app。这种方式简单直观适合开发和测试环境。但是在生产环境或者有更复杂需求时我们可能需要更精细的控制。这就引出了上下文路径Context Path配置。你可能不想让应用名my-awesome-app出现在URL里或者想指定一个固定的路径又或者想把WAR文件放在webapps目录之外的地方。这时候就需要用到Context配置。有两种主要方式在server.xml的Host标签内添加Context元素。这种方式不推荐因为修改主配置文件server.xml后重启Tomcat时如果配置有误可能导致整个Tomcat启动失败。使用独立的XML配置文件。这是官方推荐的方式。在$CATALINA_BASE/conf/Catalina/localhost/目录下如果localhost不存在就创建一个新建一个XML文件文件名决定了应用的上下文路径。比如你想通过根路径/访问应用就创建一个ROOT.xml文件想通过/api访问就创建api.xml。文件内容如下?xml version1.0 encodingUTF-8? Context docBase/path/to/your/my-awesome-app.war reloadabletrue /这个配置告诉Tomcat去docBase指定的路径加载我的应用上下文路径就是文件名不含.xml并且开启reloadable模式当检测到应用文件变化时自动重载应用方便调试生产环境建议设为false。我更喜欢把WAR包集中放在一个专门的目录比如/opt/deployments/然后通过这种方式映射。这样应用包和Tomcat本身分离开管理起来更清晰升级Tomcat时也不会影响已部署的应用。5. 核心配置调优与故障排查项目跑起来只是第一步要让它跑得稳、跑得快还得进行一些关键配置。这里我分享几个最常调整的地方和对应的排查思路。连接数调优 (server.xml)。默认的Tomcat配置可能无法应对高并发。我们需要关注conf/server.xml里的Connector配置。找到类似下面这行通常是8080端口的HTTP连接器Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /我们可以给它加上线程池和连接数相关的参数Connector port8080 protocolHTTP/1.1 maxThreads200 !-- 最大工作线程数根据服务器CPU核心数调整建议200-500 -- minSpareThreads20 !-- 最小空闲线程数 -- acceptCount100 !-- 等待队列长度当所有线程都忙时新请求在此排队 -- maxConnections10000 !-- 最大连接数 -- connectionTimeout20000 redirectPort8443 /maxThreads是最关键的参数之一它决定了Tomcat同时处理请求的能力。设置太小并发上不去设置太大会消耗过多内存和CPU上下文切换资源。一般可以先从200开始根据实际压测结果调整。JVM内存参数调优 (catalina.sh)。对于Java应用JVM内存设置不当是导致性能问题甚至崩溃的常见原因。我们需要修改Tomcat的启动脚本bin/catalina.sh如果是Windows是catalina.bat。在文件开头部分找到注释行之后添加JAVA_OPTS设置export JAVA_OPTS-server -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m-Xms512m设置JVM初始堆内存为512MB。-Xmx1024m设置JVM最大堆内存为1024MB。通常-Xms和-Xmx设为相同值可以避免运行中堆内存动态调整带来的性能波动。-XX:MetaspaceSize和-XX:MaxMetaspaceSize设置元空间Java 8以后取代永久代的初始和最大大小存放类元数据。日志分析与常见故障。出了问题别怕日志是我们最好的朋友。重点看logs目录下的两个文件catalina.out标准输出和错误日志Tomcat启动过程、System.out.println等内容在这里。localhost.yyyy-mm-dd.log应用访问日志记录每个请求的详细信息。你的应用名my-awesome-app相关的日志文件。我遇到过几个典型问题应用启动失败catalina.out里报ClassNotFoundException或NoClassDefFoundError。这通常是依赖包缺失或冲突。检查你的WAR包WEB-INF/lib下是否包含了所有必要的JAR包或者检查是否因为CLASSPATH设置问题导致加载了错误版本的库。端口被占用。启动Tomcat时报Address already in use。用sudo netstat -tlnp | grep 8080查看是哪个进程占用了8080端口然后选择停止该进程或者修改Tomcat的server.xml换一个端口。权限不足。特别是当你把Tomcat或应用日志目录、临时工作目录放在非标准位置时运行Tomcat的用户如我们之前创建的tomcat用户必须有读写权限。仔细检查logs、work、temp以及你部署WAR包目录的权限设置。内存溢出OOM。在catalina.out中看到java.lang.OutOfMemoryError。首先考虑调整上面提到的JVM内存参数-Xmx增大堆空间。如果问题依旧可能需要使用jmap、jstack等工具分析内存快照和线程栈定位是内存泄漏还是真的内存不足。在UOS上这些问题的排查思路和在其他Linux发行版上完全一致。多看看日志多搜索错误信息大部分问题都能找到解决方案。记住部署是一个不断调试和优化的过程第一次就完美跑通固然好但遇到问题并解决它才是更宝贵的经验。