Liferay 6.2（JBoss 6.4）升级后HTTPS页面CSS加载异常求助

开发者阿泽

2026-5-20

这个问题我之前帮同事排查过类似的，核心是Liferay生成资源URL时没正确识别当前的HTTPS协议，主要得从Liferay的配置入手，JBoss的配置是辅助验证的部分，下面一步步拆解：

优先排查Liferay核心配置

这些是最可能解决问题的设置，都在Liferay的portal-ext.properties文件里（如果没有就新建一个，放在Liferay的WEB-INF/classes目录下）：

强制使用HTTPS生成资源URL：
添加或修改以下配置，直接告诉Liferay所有资源都用HTTPS协议：
```
web.server.protocol=https
web.server.https.port=443
```
如果你的HTTPS端口不是默认的443，改成实际使用的端口就行。
配置Portal的绝对URL参数：
确保Portal的基础URL设置正确，避免生成相对路径时出错：
```
portal.instance.protocol=https
portal.instance.http.port=80
portal.instance.https.port=443
portal.instance.web.id=your-web-id（比如localhost，根据实际站点ID修改）
```
不确定portal.instance.web.id的话，可以登录Liferay后台，在「控制面板→服务器→服务器管理」里查看当前站点的ID。
检查自定义代码/主题的硬编码URL：
如果上面的配置都生效了还是有问题，就得排查自定义主题或Portlet里有没有硬写HTTP协议的CSS/JS引用，比如：
```
<link rel="stylesheet" href="http://your-domain.com/css/style.css">
```
这种硬编码的内容是不受配置控制的，得改成相对路径，或者用Liferay的标签库生成URL，比如用<liferay-theme:stylesheet>标签引入主题CSS，它会自动跟随Portal的协议配置。

JBoss这边主要是确保HTTPS的连接器或反向代理配置正确，让Liferay能正确识别当前请求的协议：

检查JBoss的HTTPS连接器配置：
打开JBoss的standalone.xml（或domain.xml，根据部署模式），找到<subsystem xmlns="urn:jboss:domain:web:1.4">下的<connector>节点，确保HTTPS连接器的scheme和secure属性设置正确：
```
<connector name="https" protocol="HTTP/1.1" scheme="https" secure="true" port="443">
    <ssl name="ssl" key-alias="your-key-alias" password="your-password" certificate-key-file="path/to/your/keystore.jks" protocol="TLSv1.2" verify-client="false"/>
</connector>
```
这里的scheme="https"和secure="true"是关键，JBoss会把这个信息传递给Liferay，让它知道当前请求是HTTPS协议。
如果使用了反向代理（如Nginx、Apache）：
要确保反向代理传递了X-Forwarded-Proto头给JBoss，比如Nginx里的配置：
```
proxy_set_header X-Forwarded-Proto $scheme;
```
同时在JBoss的standalone.xml里添加Valve来识别这个头，修改<host>节点：
```
<host name="default-host" alias="localhost">
    <valve class-name="org.apache.catalina.valves.RemoteIpValve" />
</host>
```
这样Liferay就能通过这个头识别到实际的请求协议是HTTPS。

改完所有配置后，重启JBoss和Liferay，然后查看页面源代码，检查CSS的URL是否已经切换为HTTPS。如果还是有问题，可以打开Liferay的日志，搜索web.server.protocol或portal.instance.protocol，确认配置是否正确加载。

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