Ubuntu下OpenJDK7搭配Tomcat8访问localhost:8080空白页求助

云原生阿岚

2026-5-19

Hey there, let's troubleshoot that blank page issue you're seeing with Tomcat 8 and OpenJDK 7 on Ubuntu. I've run into similar problems before, so here are some targeted steps to get to the bottom of it:

1. First, confirm Tomcat is running and using port 8080

Check Tomcat's service status with:
```
sudo systemctl status tomcat8
```
Look for "active (running)" in the output. If it's stopped, start it with sudo systemctl start tomcat8.
Verify no other process is hogging port 8080:
```
sudo ss -tulpn | grep 8080
```
If another process is using the port, kill it or adjust Tomcat's port in /etc/tomcat8/server.xml.

2. Double-check JDK compatibility and environment variables

Tomcat 8 requires JDK 7 or later, but make sure Tomcat is actually using your OpenJDK 7 installation:

Check your JAVA_HOME variable:
```
echo $JAVA_HOME
```
It should point to your OpenJDK 7 path, like /usr/lib/jvm/java-7-openjdk-amd64.
If JAVA_HOME is missing or incorrect, edit /etc/default/tomcat8 and set:
```
JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
```
Then restart Tomcat with sudo systemctl restart tomcat8.

3. Dig into Tomcat's logs for hidden errors

Blank pages often hide silent failures. Check these key logs:

Catalina.out: Tomcat's main log, perfect for catching startup/deployment errors:
```
sudo tail -n 50 /var/log/tomcat8/catalina.out
```
Look for SEVERE level messages—these usually flag critical issues like broken dependencies or corrupted web app files.
Localhost log: Checks for errors specific to localhost requests:
```
sudo tail -n 50 /var/log/tomcat8/localhost.log
```
Access logs: Confirm your requests are reaching Tomcat:
```
sudo tail -n 20 /var/log/tomcat8/localhost_access_log.*.txt
```
If you don't see your request entries here, a firewall or network issue might be blocking port 8080.

4. Verify the default ROOT web app is intact

Tomcat's default page comes from the ROOT web app. If this app is missing or corrupted, you'll get a blank page:

Check if the ROOT directory exists and has the right files:
```
ls -l /var/lib/tomcat8/webapps/ROOT/
```
You should see files like index.html, index.jsp, and other default assets. If the directory is empty or missing, restore the ROOT app or re-install Tomcat.
Check for successful deployment in catalina.out—look for a line like:
Deployment of web application directory [/var/lib/tomcat8/webapps/ROOT] has finished in [X] ms

5. Clear Tomcat's cache and work directories

Corrupted cache files can break page rendering. Clear them and restart Tomcat:

sudo rm -rf /var/cache/tomcat8/*
sudo rm -rf /var/lib/tomcat8/work/*
sudo systemctl restart tomcat8

6. Fix file permissions

Tomcat runs as the tomcat user by default. If it lacks read access to web apps, it can't serve pages:

Set correct ownership for the webapps directory:

sudo chown -R tomcat:tomcat /var/lib/tomcat8/webapps/

Restart Tomcat after adjusting permissions.

If none of these steps resolve the issue, share a snippet of the catalina.out log (focus on any SEVERE errors) and we can dig deeper!

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