Flask自定义Converter必须继承BaseConverter并实现to_python和to_url方法，regex属性为不带^$的字符串，to_python抛异常返回404，to_url须返回字符串且类型需与to_python一致。
Flask自定义Converter必须继承BaseConverter
不继承 BaseConverter 的类，Flask 会直接忽略，路由注册时不会报错，但匹配永远失败。常见错误是直接写个普通类、或继承了 object，结果请求 404 却查不出原因。
正确做法是让自定义类显式继承 BaseConverter，并实现 to_python 和 to_url 两个方法：
-
to_python：从 URL 字符串提取后，转换成 Python 对象（比如转成int、datetime或自定义对象），返回值会传给视图函数参数 -
to_url：反向生成 URL 时（如url_for），把 Python 值转回 URL 可用的字符串
正则匹配靠的是regex属性，不是route装饰器里的正则
很多人误以为在 @app.route('/user/<regex>')</regex> 这样写就能生效——其实 Flask 原生不支持这种语法。真正起作用的是自定义 Converter 类里的 regex 属性，它必须是字符串（不是 re.Pattern 对象）。
例如要匹配邮箱格式的路径段：
立即学习“Python免费学习笔记（深入）”；
class EmailConverter(BaseConverter):
regex = r'[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}'
然后注册：app.url_map.converters['email'] = EmailConverter，再用 /user/<addr></addr> 才有效。
注意点：
-
regex字符串不能带^或$，Flask 会自动加边界 - 如果正则里用了捕获组（
()），会导致匹配失败，只允许非捕获组(?:...) - 复杂正则建议先用
re.match(regex, path_segment)手动验证是否能匹配
to_python抛异常会直接返回404，不是500
当 to_python 方法中主动 raise ValueError 或其他异常，Flask 不会报 500，而是静默转为 404。这是设计行为，不是 bug —— 表示“这个 URL 格式不合法，不属于该路由”。
所以别在 to_python 里做数据库查询或 IO 操作；它只负责格式校验和轻量转换。例如：
def to_python(self, value):
if '@' not in value:
raise ValueError('Invalid email format')
return value.lower().strip()
常见陷阱：
- 忘记
return值，函数默认返回None，后续视图函数参数就变成None - 在
to_python里调用db.session.query(...).first()，导致每个请求都查库，且异常时还看不到日志 - 正则能匹配，但
to_python又额外校验失败，用户看到 404 却不知是正则问题还是逻辑问题
url_for生成URL时to_url没被调用？检查参数类型
url_for('user_detail', addr='test@example.com') 不触发 to_url，大概率是因为传入的 addr 已经是字符串，而你的 to_url 写成了只处理 dict 或 object 实例。Flask 调用 to_url 的前提是：传给 url_for 的值类型与 to_python 返回的类型一致，且该类型需要进一步格式化。
典型场景是自定义了 User 类型转换器，to_python 返回 User(id=123)，那么 url_for('profile', user=User(123)) 才会进 to_url。如果误传字符串 '123'，Flask 就跳过它，直接拼接。
调试建议：
- 在
to_url开头加print(f'to_url called with {value!r}')确认是否执行 - 确保
to_python和url_for两端使用同一类型对象 -
to_url必须返回字符串，返回None或数字会引发BuildError
url_for 静默失败这类情况，最容易花半天时间怀疑路由写法，其实卡在 regex 字符串多写了 ^ 或 to_python 忘了 return。 
