feat: default compatible mode for native serialization#3742
Merged
chaokunyang merged 7 commits intoJun 5, 2026
Merged
Conversation
38c1a49 to
356174f
Compare
LiangliangSui
approved these changes
Jun 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why?
Native-mode Fory instances previously defaulted to schema-consistent mode while xlang instances defaulted to compatible mode. That made the default less robust for schema evolution and left docs/tests dependent on implicit mode behavior.
What does this PR do?
compatible=falseavailable for same-schema workloads that need faster serialization and smaller size.compatible=falseis appropriate: only when every reader and writer uses the same schema, or when xlang schemas are verified across languages or generated from Fory schema IDL.runtimephrasing, and examples that configured unrelated options in configuration sections.Related issues
None.
AI Contribution Checklist
yes/noyes, I included a completed AI Contribution Checklist in this PR description and the requiredAI Usage Disclosure.yes, my PR description includes the requiredai_reviewsummary and screenshot evidence of the final clean AI review results from both fresh reviewers on the current PR diff or current HEAD after the latest code changes.AI Usage Disclosure
This PR used AI assistance to audit cross-language docs, update compatible-mode guidance, add explicit compatibility settings in tests and benchmarks, and iterate on CI failures. The author reviewed the generated changes, ran focused local verification, and monitored GitHub Actions to green.
ai_review
No actionable findings.Does this PR introduce any user-facing change?
Yes. Compatible mode is now the default for Fory construction, including native mode. Users who always serialize and deserialize with the same schema can set
compatible=falseexplicitly for faster serialization and smaller size.Benchmark
No benchmark result changes are included. Benchmark setup code was updated so Fory compatibility mode is explicit after the default change.