Fail fast + docs around mixing major Scala versions serializing #22004

This commit is contained in:
Johan Andrén 2017-02-14 12:21:04 +01:00 committed by GitHub
parent 958de6a916
commit 70f2beaf0b
5 changed files with 40 additions and 0 deletions

View file

@ -215,6 +215,18 @@ thread-local variable, so be sure to have it set while deserializing anything
which might contain actor references.
Serialization compatibility
===========================
It is not safe to mix major Scala versions when using the Java serialization as Scala does not guarantee compatibility
and this could lead to very surprising errors.
If using the Akka Protobuf serializers (implicitly with ``akka.actor.allow-java-serialization = off`` or explicitly with
``enable-additional-serialization-bindings = true``) for the internal Akka messages those will not require the same major
Scala version however you must also ensure the serializers used for your own types does not introduce the same
incompatibility as Java serialization does.
External Akka Serializers
=========================