Sections

Error Reference

Error reference section.

No section

POSKeyError
POSKeyError means that you have an error in your database, and appears when you have database corruption.
InvalidObjectReference
InvalidObjectReference - Error Value: Attempt to store an object from a foreign database connection.
RuntimeError: Shouldn't load state
RuntimeError: Shouldn't load state for 00000000002a028d when the connection is closed (Also, an error occurred while attempting to render the standard error message.
KeyError
This error appears when you're trying to access something that doesn't exist in an attribute.
The bucket being iterated changed size !
This is a problem that existed in the sessioning machinery in Zope 2.7.x
EmergencyUserCannotOwn
When trying to add an object in your Zope instance, you get "EmergencyUserCannotOwn".
Nested page template errors !
If you have a page template which uses a macro, and the page template which defines the macro has an error, it's difficult to track down the error.
TypeError: unsubscriptable object
"Type Error: unsubscriptable object" occurs in an Archetypes based object after pressing the save button of the base_edit form.
Attribute Error: archetype_tool / mimetype_registry / reference_catalog
After re- or uninstalling an Archetypes-related Product, this error can appear. AttributeErrors for mimetype_registry or reference_catalog may also be symptoms of the same problem.
PTRuntimeError: FS Page Template my_template has errors
This error normally occurs when you have a syntax error or HTML error in your template. Here's how to troubleshoot and fix it.
Copy Error
Copy errors may occur when a Plone user adds a Zope folder through the ZMI and attempts to paste Plone objects inside that folder
Infinite Recursion Error (Catalog)
When I catalog an object I sometimes get a infinite recursion error. Why?
TypeError: get_field() takes exactly 2 arguments (3 given)
A common error when the API has changed.
AttributeError related to getGroups or getLocalRolesForDisplay
This error is normally caused by the lack of a Group User Folder.
Copy Error on Import
You get a Copy Error when trying to import an object.
Insufficient privileges
When you get an Unauthorized exception ("Insufficient privileges"), it's often difficult to determine exactly which permission is causing the problem. Enter VerboseSecurity.
AttributeError: 'NoneType' object has no attribute 'keys'
I got this error when switching between OrderedBaseFolder and a BTree-based equivalent in Archetypes, the actual error can be a lot of things, but thought I would document this particular instance of it here.
Internet Explorer - 500 internal server error, even on localhost
IE becomes unable to 'see' your plone server via localhost or any URI, but other browsers see the server fine.
AttributeError: 'module' object has no attribute 'flock'
If you try installing Plone on an IBM Thinkpad or PC, its Python install conflicts with the Plone one.
AttributeError regarding NoneType in Catalog Results
While using .getObject() on a brain (the values returned by a catalog search result) a NoneType can be returned. This will cause an AttributeError in Zope 2.7; in Zope 2.8 it raises an exception either KeyError or AttributeError immedaitely.
'str' object has no value 'getId' (using PasswordResetTool and CMFMember) !
When a user registers on the site, if they tick 'Send me a copy of my password' - they get an error.
WebDAV tests on Mac !
If you get a failure on testPUTImageICONoContentType, on a Mac this is the resolution.
'group_' Error when assigning roles to users and/or groups !
This error occurs when attempting to assign Roles to Groups in Plone 2.0.x when using the Debian packages for Plone installation/maintenance or you're using GRUF3.
Infinite recursion error: __call__() in Plone 2.1 !
After importing content into a plone 2.1 site you get an 'Infinite recursion' error related to PortalContent.__call__() displayed when trying to view the imported content
MimeTypeException: Malformed MIME type (t) !
Exception occurs when you try to view/edit your Archetypes object: MimeTypeException: Malformed MIME type (t)
DeprecationWarning
Example: DeprecationWarning: The XYZ parameter of XYZ is deprecated and will be ignored in CMF X.Y: XYZ
TypeError: argument 1 must be string in constructor
TypeError: argument 1 must be string, not YourTool A construtor seems to take string argument instead of self.
Field Accessor yields None
Name clashes of accessors and methods inherited from base classes are not caught.
function attributes not accessible in restricted mode
The error "function attributes not accessible in restricted mode" means you're operating on a function when you think you're operating on the result of calling that function.
KeyError: 'ACTUAL_URL' (Also, an error occurred while attempting to render the standard error message.) !
If Plone 2.1 fails to render immediately upon installation, you are probably running a Zope version prior to 2.7.4. Upgrading will fix the problem
KeyError during restrictedTraverse !
Page template engine is unable to find files. KeyError occuring during restrictedTraverse. E.g. KeyError: 'field'.
AttributeError: _length !
When you upgrade from Zope 2.7.x to 2.8.1 you get this error on most of the portal_catalog operations.
Uploaded images aren't shown in view/ aren't resized
An image uploaded in an Archetypes-based object shows only up in the 'Edit' form (in original size) and do not show up (resized) in the 'View'.
AttributeError: getBodyTagClass !
If you customize 'main_template' and get an AttributeError on 'getBodyTagClass' you have probably customized the wrong 'main_template'.
Portal content has gone missing !
Plone doesn't show any content though everything seem to be present when you view your site structure through Zope Management Interface
Product's initialize() is not called in unit tests !
A product's initialize() in __init__.py is not called in unit testing, leading to all sorts of missing type errors
Functional testing: The object at x has an empty or missing docstring. !
You get error "Zope has encountered a problem publishing your object. The object at x has an empty or missing docstring."
AttributeError: manage_addTool !
AttributeError: manage_addTool exception is thrown when trying to quick install a new product
Class declaration fails and complains about number of arguments
For example: class Record(BaseBTreeFolder): TypeError: function takes at most 2 arguments (3 given)
Quick installer doesn't find a product !
You have copied a new product to Plone's Products folder, but the quick installer cannot find it.
No such file or directory: 'images/version.gif' !
When launching Zope in debug mode, Zope refuses to start because of broken product OFSP. Traceback claims that image file is missing.
'isPrincipiaFolderish' of None, acquired through (Products) !
Skin rendering fails and hiddenStructure becomes visible. Plone default styles are missing, because Plone default CSS seems to be not used. If one runs in debug mode, an exception traceback is available in event.log.
RichWidget fails to format text in view mode !
RichWidget doesn't format text in view mode but displays it as plain text
Setup error: Executing command setupSite.pyfailed (MimeTypes error) !
When setting up Plone on Windows XP, an error is encountered while executing the setupSite.py script. The error lies within the MimeTypes script and produces the following message: Executing the command setupSite.py' failed. Index error: String index out of range.
AttributeError: navigation_properties !
When installing a product in Plone you get: AttributeError: navigation_properties
AttributeError: toPortalTime !
In Plone 2.1.2 or 2.5 you get an error message: AttributeError: toPortalTime
log() got an unexpected keyword argument 'error'
This error shows up on systems using access rules running a particular Zope version with Plone.
2.1.x -> 2.5.2: Error value: 'NoneType' object has no attribute 'addMember' !
When Migrating from 2.1.3 or 2.1.4 to 2.5.2, some Plone instances may raise the error: Error value: 'NoneType' object has no attribute 'addMember'
Unauthorized: You are not allowed to access 'xxx.yyy' in this context !
When creating a new item the user cannot get to the initial edit page
Members Can't Create Folders Through WebDAV
Using a WebDAV client on a Plone site, sitre users are unable to create new folders directories where they have Owner role.
Buildout breaks with zope.component 3.6.0 release
All of a sudden your buildout, which worked fine yesterday, stops working and you get "ImportError: No module named ImplPython".
Past events don't show up in the "Past Events" sub-collection
In a default Plone site, the default "Past Events" sub-collection in events/aggregator/previous is empty even after having created events starting and ending in the past.
Hanging download of Office documents
Hanging download of Office documents might be caused by level 5 content rules in CISCO switch
socket.error: AF_UNIX path too long
socket.error: AF_UNIX path too long

Frequently encountered

EmergencyUserCannotOwn
When trying to add an object in your Zope instance, you get "EmergencyUserCannotOwn".
PTRuntimeError: FS Page Template my_template has errors
This error normally occurs when you have a syntax error or HTML error in your template. Here's how to troubleshoot and fix it.
Insufficient privileges
When you get an Unauthorized exception ("Insufficient privileges"), it's often difficult to determine exactly which permission is causing the problem. Enter VerboseSecurity.
DeprecationWarning
Example: DeprecationWarning: The XYZ parameter of XYZ is deprecated and will be ignored in CMF X.Y: XYZ
python.exe Unable to locate Component - pywintypes23.dll not found !
python.exe Unable to locate Component - [..] pywintypes23.dll not found [..]
2.1.x -> 2.5.2: Error value: 'NoneType' object has no attribute 'addMember' !
When Migrating from 2.1.3 or 2.1.4 to 2.5.2, some Plone instances may raise the error: Error value: 'NoneType' object has no attribute 'addMember'
Unauthorized: Not authorized to access binding: context
How to find out the REAL source of the dreaded "Not authorized to access binding: context" error.
SyntaxError: 'return' outside function
In a Plone context, you can see this error while running Buildout.

General

POSKeyError
POSKeyError means that you have an error in your database, and appears when you have database corruption.
InvalidObjectReference
InvalidObjectReference - Error Value: Attempt to store an object from a foreign database connection.
RuntimeError: Shouldn't load state
RuntimeError: Shouldn't load state for 00000000002a028d when the connection is closed (Also, an error occurred while attempting to render the standard error message.
KeyError
This error appears when you're trying to access something that doesn't exist in an attribute.
The bucket being iterated changed size !
This is a problem that existed in the sessioning machinery in Zope 2.7.x
Nested page template errors !
If you have a page template which uses a macro, and the page template which defines the macro has an error, it's difficult to track down the error.
Copy Error
Copy errors may occur when a Plone user adds a Zope folder through the ZMI and attempts to paste Plone objects inside that folder
Infinite Recursion Error (Catalog)
When I catalog an object I sometimes get a infinite recursion error. Why?
ValueError: Cache values may only be in one cache.
This is a low-level ZODB error that may sometimes happen when you refresh a Product without restarting Zope. It therefore is almost never seen in production. Restart will fix it.
TypeError: get_field() takes exactly 2 arguments (3 given)
A common error when the API has changed.
AttributeError related to getGroups or getLocalRolesForDisplay
This error is normally caused by the lack of a Group User Folder.
Copy Error on Import
You get a Copy Error when trying to import an object.
Internet Explorer - 500 internal server error, even on localhost
IE becomes unable to 'see' your plone server via localhost or any URI, but other browsers see the server fine.
AttributeError: 'module' object has no attribute 'flock'
If you try installing Plone on an IBM Thinkpad or PC, its Python install conflicts with the Plone one.
AttributeError regarding NoneType in Catalog Results
While using .getObject() on a brain (the values returned by a catalog search result) a NoneType can be returned. This will cause an AttributeError in Zope 2.7; in Zope 2.8 it raises an exception either KeyError or AttributeError immedaitely.
'str' object has no value 'getId' (using PasswordResetTool and CMFMember) !
When a user registers on the site, if they tick 'Send me a copy of my password' - they get an error.
WebDAV tests on Mac !
If you get a failure on testPUTImageICONoContentType, on a Mac this is the resolution.
'group_' Error when assigning roles to users and/or groups !
This error occurs when attempting to assign Roles to Groups in Plone 2.0.x when using the Debian packages for Plone installation/maintenance or you're using GRUF3.
Infinite recursion error: __call__() in Plone 2.1 !
After importing content into a plone 2.1 site you get an 'Infinite recursion' error related to PortalContent.__call__() displayed when trying to view the imported content
TypeError: argument 1 must be string in constructor
TypeError: argument 1 must be string, not YourTool A construtor seems to take string argument instead of self.
function attributes not accessible in restricted mode
The error "function attributes not accessible in restricted mode" means you're operating on a function when you think you're operating on the result of calling that function.
KeyError: 'ACTUAL_URL' (Also, an error occurred while attempting to render the standard error message.) !
If Plone 2.1 fails to render immediately upon installation, you are probably running a Zope version prior to 2.7.4. Upgrading will fix the problem
KeyError during restrictedTraverse !
Page template engine is unable to find files. KeyError occuring during restrictedTraverse. E.g. KeyError: 'field'.
AttributeError: _length !
When you upgrade from Zope 2.7.x to 2.8.1 you get this error on most of the portal_catalog operations.
IndexError: list index out of range
createObject raises strange IndexError: list index out of range
AttributeError: getBodyTagClass !
If you customize 'main_template' and get an AttributeError on 'getBodyTagClass' you have probably customized the wrong 'main_template'.
Portal content has gone missing !
Plone doesn't show any content though everything seem to be present when you view your site structure through Zope Management Interface
Gaierror
Gaierrors occur when the server network services are not correctly configured or when a firewall is blocking nameserver lookups.
Product's initialize() is not called in unit tests !
A product's initialize() in __init__.py is not called in unit testing, leading to all sorts of missing type errors
Functional testing: The object at x has an empty or missing docstring. !
You get error "Zope has encountered a problem publishing your object. The object at x has an empty or missing docstring."
AttributeError: manage_addTool !
AttributeError: manage_addTool exception is thrown when trying to quick install a new product
Class declaration fails and complains about number of arguments
For example: class Record(BaseBTreeFolder): TypeError: function takes at most 2 arguments (3 given)
Quick installer doesn't find a product !
You have copied a new product to Plone's Products folder, but the quick installer cannot find it.
No such file or directory: 'images/version.gif' !
When launching Zope in debug mode, Zope refuses to start because of broken product OFSP. Traceback claims that image file is missing.
'isPrincipiaFolderish' of None, acquired through (Products) !
Skin rendering fails and hiddenStructure becomes visible. Plone default styles are missing, because Plone default CSS seems to be not used. If one runs in debug mode, an exception traceback is available in event.log.
RichWidget fails to format text in view mode !
RichWidget doesn't format text in view mode but displays it as plain text
Setup error: Executing command setupSite.pyfailed (MimeTypes error) !
When setting up Plone on Windows XP, an error is encountered while executing the setupSite.py script. The error lies within the MimeTypes script and produces the following message: Executing the command setupSite.py' failed. Index error: String index out of range.
AttributeError: navigation_properties !
When installing a product in Plone you get: AttributeError: navigation_properties
IOError: decoder jpeg not available
You've installed the Python Imaging Libraries (PIL). Yet when you upload or manipulate an image, you get the error message: IOError: decoder jpeg not available.
ImportError: No module named ImplPython
Plone instance does not start or running unit tests fails with Python exception: ImportError: No module named ImplPython
AttributeError: toPortalTime !
In Plone 2.1.2 or 2.5 you get an error message: AttributeError: toPortalTime
log() got an unexpected keyword argument 'error'
This error shows up on systems using access rules running a particular Zope version with Plone.
StorageError: Quota Exceeded
During testing, if the necessary memory exceeds 1MB, the tests will run.
Unauthorized: You are not allowed to access 'xxx.yyy' in this context !
When creating a new item the user cannot get to the initial edit page
Members Can't Create Folders Through WebDAV
Using a WebDAV client on a Plone site, sitre users are unable to create new folders directories where they have Owner role.
Permission denied: ... .python-eggs
Product installation failure due to failure to create egg cache
KeyError: 'main_template'
Error occurring when you attempt to view any context that calls main_tempate
Unauthorized: The owner of the executing script is defined outside the context of the object being accessed. The script has proxy roles, but they do not apply in this context. !
You did everything you could to make sure your workflow script has the necessary permissions to do what it needs to do and it still does not work? Check this
Internet Explorer: Can't download files over https
IE protests that it cannot find the file you are attempting to download. This occurs when you are using https and have cache control headers set (for instance if you're using CacheFu).
TypeError: iteration over non-sequence
Cannot view the site after moving Data.fs to a new server
validateSingleEmailAddress
You may encounter this error when registering new members. It will cause the registering to fail.
Python crashes on Mac OS X (lxml related)
The famous lxml crash, and what to do about it
AttributeError: 'long' object has no attribute 'get'
ZODB3 /ZODB/FileStorage/FileStorage.py", ... in _restore_index index = info.get('index') AttributeError: 'long' object has no attribute 'get'

Archetypes

TypeError: unsubscriptable object
"Type Error: unsubscriptable object" occurs in an Archetypes based object after pressing the save button of the base_edit form.
Attribute Error: archetype_tool / mimetype_registry / reference_catalog
After re- or uninstalling an Archetypes-related Product, this error can appear. AttributeErrors for mimetype_registry or reference_catalog may also be symptoms of the same problem.
ValueError: Cache values may only be in one cache.
This is a low-level ZODB error that may sometimes happen when you refresh a Product without restarting Zope. It therefore is almost never seen in production. Restart will fix it.
AttributeError: 'NoneType' object has no attribute 'keys'
I got this error when switching between OrderedBaseFolder and a BTree-based equivalent in Archetypes, the actual error can be a lot of things, but thought I would document this particular instance of it here.
MimeTypeException: Malformed MIME type (t) !
Exception occurs when you try to view/edit your Archetypes object: MimeTypeException: Malformed MIME type (t)
Field Accessor yields None
Name clashes of accessors and methods inherited from base classes are not caught.
IndexError: list index out of range
createObject raises strange IndexError: list index out of range
Uploaded images aren't shown in view/ aren't resized
An image uploaded in an Archetypes-based object shows only up in the 'Edit' form (in original size) and do not show up (resized) in the 'View'.
python.exe Unable to locate Component - pywintypes23.dll not found !
python.exe Unable to locate Component - [..] pywintypes23.dll not found [..]
AttributeError: test_user_1_ !
Unit tests fail when trying create content using invokeFactory() on Plone 2.5.1/Zope 2.9.4
Cache values may only be in one cache
Cache values may only be in one cache when developing product
AttributeError: reference_catalog
When adding Archetype field to python property bridges, be careful with ReferenceFields - they must be ATReferenceFieldProperty, not ATFieldProperty.