使用PrettyFaces时HTTPS协议被转为HTTP的问题求助

我之前帮不少开发者解决过这个PrettyFaces + HTTPS的协议跳转问题，核心原因是PrettyFaces默认没有正确识别当前请求的HTTPS上下文，导致生成的pretty:前缀路由链接回退到HTTP。下面是几个靠谱的解决方案，按适用场景排序：

1. 全局强制所有PrettyFaces路由使用HTTPS #

如果你的生产环境全程使用HTTPS，最简单的方式是在pretty-config.xml中添加全局配置，让所有通过pretty:生成的链接默认使用HTTPS：

<global>
  <secure>true</secure>
</global>

这个配置会覆盖单个路由的设置，从根源上避免协议切换问题。

2. 为特定路由单独设置HTTPS #

如果你的应用同时存在HTTP和HTTPS路由，只想对特定页面（比如main-page）强制HTTPS，可以在对应的URL Mapping里添加secure="true"属性：

<url-mapping id="mainPage">
  <pattern value="/main-page" />
  <view-id value="/pages/main.xhtml" />
  <secure>true</secure> <!-- 强制这个路由生成HTTPS链接 -->
</url-mapping>

3. 让PrettyFaces自动识别当前请求协议 #

如果你的应用需要适配多环境（比如开发用HTTP，生产用HTTPS），可以通过上下文参数让PrettyFaces自动检测当前请求的协议：
在web.xml中添加以下配置：

<context-param>
  <param-name>com.ocpsoft.pretty.faces.secure</param-name>
  <param-value>AUTO</param-value>
</context-param>

这样PrettyFaces会根据当前请求的协议（HTTP/HTTPS）自动生成对应协议的URL，无需手动切换配置。

4. 排查反向代理/SSL终止的头传递问题 #

如果你的应用部署在反向代理（比如Nginx、Apache）后面，且SSL在代理层终止，那应用服务器可能无法正确识别当前协议是HTTPS。这种情况下需要：

• 在反向代理配置中传递X-Forwarded-Proto头，以Nginx为例：

  proxy_set_header X-Forwarded-Proto $scheme;
  

• 然后在web.xml中配置PrettyFaces识别这个头：

  <context-param>
    <param-name>com.ocpsoft.pretty.faces.proxy.header</param-name>
    <param-value>X-Forwarded-Proto</param-value>
  </context-param>
  

这样PrettyFaces就能通过代理传递的头正确判断当前协议，生成正确的URL。

额外注意事项 #

• 确保你的<h:commandLink>的action属性只使用pretty:前缀的路由，不要硬编码HTTP链接；
• 检查JSF的状态保存配置（javax.faces.STATE_SAVING_METHOD），默认的server模式不会影响协议生成；
• 测试时清空浏览器缓存，避免旧的HTTP链接被缓存导致误导。

内容的提问来源于stack exchange，提问作者Benigno Sales