不能同时生效——HINT 会覆盖自动分片逻辑，强制走指定数据源或分片键；其优先级高于自动分片规则，仅在全局广播表DDL或分布式事务绑定场景下可合理共存。
ShardingSphere 的 HINT 路由和自动分片能同时生效吗？
不能直接混合生效——HINT 一旦写入，会覆盖自动分片逻辑，强制走指定数据源或分片键值。这不是 bug，是设计使然：ShardingSphere 的路由决策是单入口、优先级明确的，HINT 层级高于分片规则解析。
常见错误现象：INSERT INTO t_order 原本按 user_id 分库，但加了 HINT 指定 ds_1 后，SQL 却报 Cannot find actual data source 或写入到错误表（比如 t_order_2 而非 t_order_0），说明分片键没被忽略，但 HINT 又没完全接管——本质是配置冲突。
- 使用场景只在两类情况合理共存：① 全局广播表 +
HINT强制某库执行 DDL；② 分布式事务中，用HINT绑定连接与分片键，避免跨库事务升级为 XA -
HINT的优先级顺序固定：set sharding_hint_database_value>set sharding_hint_table_value> 自动分片规则 - 若需“部分强制、部分自动”，必须改写 SQL 或拆成两个逻辑：先用
HINT查主表，再用自动分片查关联子表（不推荐跨路由混用）
sharding_hint_database_value 和 sharding_hint_table_value 怎么设才不翻车？
这两个值不是任意字符串，必须严格匹配你在 sharding-rules 中定义的 actual-data-nodes 里的数据源名和逻辑表名格式。设错一个字符，就触发默认路由或报错。
典型翻车点：actual-data-nodes: ds_${0..1}.t_order_${0..3}，结果你 set sharding_hint_database_value = 'ds-0'（用了短横线而非下划线），或者 set sharding_hint_table_value = 't_order_4'（超出预定义范围）。
- 数据库名必须是
DataSourceConfiguration中注册的 key，比如ds_0、ds_1，不能是 JDBC URL 里的库名 - 表名必须是逻辑表名（如
t_order）或真实表名（如t_order_2），取决于你是否开启use-original-sql；默认走逻辑表名，ShardingSphere 再根据规则映射 - 若启用读写分离，
HINT只作用于写库；想强制读从库，得额外配readwrite-splitting的hint规则，两者不互通
Spring Boot 里用 HintManager 设置 HINT，为什么事务一提交就失效？
HintManager 是 ThreadLocal 实现，生命周期绑定当前线程。事务提交后，连接归还连接池，HINT 上下文自然销毁——这不是泄漏，是预期行为。但很多人误以为“设一次，全程有效”，结果在 service 方法里设了 HINT，调另一个 @Transactional 方法时发现没生效。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
常见错误现象：第一个 DAO 方法写入 ds_0 成功，第二个 DAO 方法却走到 ds_1，日志里看不到任何 HINT 相关 warn。
- 必须在同一线程、同一事务内完成所有依赖
HINT的操作；跨线程（比如@Async）、跨事务（REQUIRES_NEW）都会丢失 - 不要在 filter 或 interceptor 里全局 set
HINT，除非你能 100% 控制后续所有 DAO 调用都在该线程上下文中 - 更稳妥的做法：把
HINT逻辑下沉到 DAO 层，每次执行前显式HintManager.getInstance().setDatabaseShardingValue(...)，用 try-finally 清理
ShardingSphere-Proxy 里怎么传 HINT？客户端不支持 JDBC 时怎么办？
Proxy 不吃 JDBC 的 set 命令，它只认 SQL 注释里的 hint。JDBC 客户端可以走标准方式，但 HTTP、MySQL 客户端（比如 Navicat、Python pymysql）必须用注释语法。
容易踩的坑：写了 /* sharding hint */ SELECT * FROM t_order，但没加空格、大小写不一致，或用了双引号包裹值——Proxy 解析器很严格。
- 正确格式：
/* SHARDING HINT: database=ds_0, table=t_order_1 */ SELECT * FROM t_order - database 和 table 值必须小写、无空格、与配置完全一致；多个 hint 用英文逗号分隔
- Proxy 5.3.0+ 支持
/* SHARDING HINT: force=true */强制跳过分片解析，但仅限于全库广播类操作，慎用 - 注意：注释 hint 在 prepareStatement 场景下可能被驱动过滤，建议用普通 statement 执行
复杂点在于，HINT 和分片规则不是叠加关系，而是开关切换。一旦打开，自动分片就退场；关掉又得重新校验规则一致性。最容易被忽略的是多数据源混合部署时，不同集群的 HINT 值命名空间是否冲突——比如都叫 ds_0，但实际指向不同物理库。
