cas 5.3.x登录配置取消自定义状态拦截

Question

cas 5.3.x 配置 cas.view.default-401-page-enabled=false 出现这个问题 Caused by: org.springframework.boot.bind.RelaxedBindingNotWritablePropertyException: Failed to bind 'cas.view.resolve-redirects' from 'applicationConfig: [classpath:/application.properties]' to 'view.resolve-redirects' property on 'org.apereo.cas.configuration.CasConfigurationProperties'

Answer 1

上午好☀️☀️☀️️
本答案参考通义千问

在使用 CAS 5.3.x 时，如果你尝试通过配置 cas.view.default-401-page-enabled=false 来取消自定义状态拦截（例如 401 页面），但遇到了如下错误：

Caused by: org.springframework.boot.bind.RelaxedBindingNotWritablePropertyException: Failed to bind 'cas.view.resolve-redirects' from 'applicationConfig: [classpath:/application.properties]' to 'view.resolve-redirects' property on 'org.apereo.cas.configuration.CasConfigurationProperties'

这表明你的配置文件中存在一个 无效或不支持的属性，导致 Spring Boot 无法正确绑定 CAS 的配置属性。

---

✅ 问题分析

1. 配置项不正确

你可能误用了某个属性名。CAS 的配置项是基于 Spring Boot 的 Relaxed Binding 机制，因此需要严格按照其命名规则来设置。

2. cas.view.default-401-page-enabled=false 的作用

该配置用于控制是否启用默认的 401 页面（即未授权访问时的页面）。但这个配置项在 CAS 5.3.x 中可能已经被移除或更改了名称。

3. cas.view.resolve-redirects 是一个只读属性

你试图修改的是一个 只读属性，所以 Spring Boot 抛出异常。

---

🧠 解决方案

1. 确认正确的配置项

CAS 5.3.x 中控制 401 页面的配置项是：

cas.view.show-401-page=false

注意： 这个配置项是否可用取决于 CAS 的版本和构建方式。有些版本中可能已经不再支持此功能。

---

2. 禁用默认 401 页面的正确方式

如果目标是不显示默认的 401 页面，可以尝试以下方法：

✅ 方法一：自定义 401 页面（推荐）

你可以通过自定义 401 页面来替代默认页面，或者直接返回空内容。

cas.view.default-401-page-enabled=false

如果你仍然遇到错误，可能是由于你使用的 CAS 版本不支持该配置项。

---

3. 检查配置文件格式

确保你的 application.properties 或 application.yml 文件格式正确，并且没有拼写错误。

---

4. 排除冲突的配置项

你提到的错误信息中还包含：

Failed to bind 'cas.view.resolve-redirects' from 'applicationConfig: [classpath:/application.properties]' to 'view.resolve-redirects' property on 'org.apereo.cas.configuration.CasConfigurationProperties'

这意味着你在配置文件中设置了 cas.view.resolve-redirects 属性，但该属性是只读的，不能被修改。

解决办法： 删除或注释掉 cas.view.resolve-redirects 的配置。

---

🔧 修改后的配置示例

✅ 正确的配置（推荐）：

# 禁用默认的 401 页面（若支持）
cas.view.show-401-page=false

# 可选：禁用默认的 403 页面
cas.view.show-403-page=false

# 不要设置 cas.view.resolve-redirects，它是只读属性
# cas.view.resolve-redirects=true

---

📌 总结

| 问题 | 解决方案 | |------|----------| | cas.view.default-401-page-enabled=false 配置无效 | 使用 cas.view.show-401-page=false 替代 | | cas.view.resolve-redirects 无法绑定 | 不要设置该属性，它是只读的 | | 配置文件格式错误 | 检查拼写、缩进、换行等格式问题 |

---

🧪 附：CAS 5.3.x 支持的常用配置项（部分）

| 配置项 | 说明 | |--------|------| | cas.view.show-401-page | 是否显示默认的 401 页面 | | cas.view.show-403-page | 是否显示默认的 403 页面 | | cas.view.default-login-page-url | 自定义登录页面 URL | | cas.view.logout-view-url | 登出后跳转的页面 | | cas.view.error-page-url | 错误页面 URL |

---

如需进一步调试，建议查看 CAS 的官方文档或源码中的 CasConfigurationProperties 类，以确认支持的配置项。