Gallery:疑难解答

Gallery2疑难解答

Gallery2疑难解答的更多链接：Category:Gallery 2:Troubleshooting

需要预先做好的工作

1. 清除Gallery缓存！-参见如何清除缓存数据？
2. 确保Gallery应用程序文件完好无损！-常见问题：如何确保安装文件完整无损？
3. 清除web浏览器缓存（cookies及页面缓存）！
4. 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息

重要提示： 如果你没有以管理员身份登录的话，你需要启用'buffered'debug模式来检查错误名称及详细信息。参见：常见问题：如何设置/使用Gallery的debug模式？。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。

解决手段...

你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。

错误名称（Error Name）

是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。

错误名称	解决办法
ERROR_PLATFORM_FAILURE	常见问题：如何修复Gallery存储文件夹文件系统权限问题？
ERROR_OBSOLETE_DATA	常见问题：如何清除缓存数据？
ERROR_REQUEST_FORGED	登出或清除浏览器cookies并重试。 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保使用的整合是最新版本的。
ERROR_STORAGE_FAILURE	一般情况是，某数据库表格崩溃或数据库连接无法运作。 启用'buffered' debug模式来检查详细信息，刷新页面并在页面内容中搜索'error'。 如果某特定表格崩溃了，而你具有服务器shell访问权限的话，就可以尝试在phpmyadmin中或使用命令行中的'mysqlchk'/'misamchk'来进行修复。 或许你的webhost限制了单位小时内数据库查询可执行数。参见常见问题：我可能碰上了某种MySQL查询限制，该怎么办呢？ 常见问题：发生了'Illegal mix of collations'这样的错误，该怎么办？ 常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？
ERROR_BAD_PARAMETER	是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
ERROR_LOCK_TIMEOUT	参见常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？
ERROR_MISSING_ITEM	如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：额外组件的安装。 需要做的：为手动修复此类问题的相关指导添加链接。

错误症状（Symptom）/尝试性动作（Attempted Action）

请在下面的分类中定位你碰到的问题。请记住，debug模式启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。

安装

错误症状/尝试性动作	解决办法
无法通过验证（第二步）/login.txt	参见常见问题：为什么安装程序不接受我的login.txt？
系统检查（System Checks）报告了有关'文件完整性'的问题	参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
存储的安装（Storage Setup）（第四步）-创建目录结构错误	此错误多发生于Windows/IIS服务器。参见Windows Server中的安装 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时	如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看有关web服务器错误日志的相关信息。
失去对话（Losing Session）/回退到验证步骤	如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：常见问题：在论坛寻求帮助时哪些信息是必要的？
数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息	数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
数据库安装（Database Setup）（第五步）-客户端不支持验证协议	参见常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？以及常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"
数据库安装（Database Setup）（第五步）-其他的连接问题	这些通常是与Gallery无明显关系的数据库问题。你需要保证PHP能够与数据库进行沟通。使用Google来查找有关错误消息的信息是个不错的开端。 某特殊情况是：常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？
数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port）	如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
安装核心模块（Install Core Module）（第八步）失败	参见常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告） 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。 刷新页面或重新进行该步骤是没用的。 有时重新运行安装程序可以解决问题。 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。

升级

错误症状/尝试性动作	解决办法
无法通过验证（第二步）/login.txt	参见常见问题：为什么安装程序不接受我的login.txt？（同样适用于升级向导）
系统检查（System Checks）报告了有关'文件完整性'的问题	参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
系统检查（System Checks）报告有关'存储目录权限（Storage Directory Permissions）'的问题	参见常见问题：如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？
核心模块升级步骤由于出错而失败	是否在debug输出中看到'Illegal mix of collations'？参见MySQL UTF8 Upgrade
其他模块升级步骤报告有插件丢失	如果升级时没有包含这些模块的话，你的Gallery就有可能无法正常运行的风险。你应当尝试获取这些插件的最新版本，并在继续升级程序中的下一步之前将它们置入你的Gallery modules/和themes/ 文件夹中。 另见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
在升级结束后，某些东西将不复运行	可能某插件丢失或不处于激活状态。查看一下站点管理（Site Admin） -> 插件（Plugins）（G2.2版本，之前版本是模块（Modules）)并确保它们各司其职。

图片

错误症状/尝试性动作	解决办法
无法正常生成缩略图或重设尺寸的图片	参见常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
不显示任何图片	连原始（全尺寸）图片都不显示了吗？ 参见常见问题：图片无法显示，相册/相片的链接无效，我该怎么办？ 也许你的webhost令图片传输崩溃了。你的webhost是否在你的网站所有页面中自动添加广告或商业信息？如果是的话，这很可能就是导致出问题的原因。询问你的webhost看看能否让你自己手动添加广告并禁用自动广告添加，因为这会令你的Gallery2崩溃。 如果原始图片能正常显示，但是缩略图和重设尺寸的图片不可以的话，请参看常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
当尝试进行缩略图或重设尺寸图片创建时发生错误	先将图片工具包卸载再重新进行安装。详细信息见于：常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
缩略图（不）呈方（矩）形而不按正常的长宽比显示	当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
尝试查看图片时发生错误	是何种错误？参见以下有关'按错误名称解决问题'部分。
图片的读取速度太慢	Apache的mod_deflate/gzip没有对二进制文件禁用？ 服务器CPU，文件I/O或是带宽限制？参见性能调校技巧
较大尺寸的图片变形/崩溃	此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。

视频/Flash

错误症状/尝试性动作	解决办法
显示的是下载链接而不是期望的电影播放器	是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（对类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。 注：如果ffmpeg模块处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
视频无缩略图	ffmpeg模块是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
无法定位ffmpeg二进制	请参考ffmpeg模块获取更详细的信息。
电影无法播放	参见常见问题：为什么电影无法在我的Gallery中播放了？

添加项目/相册/上传

错误症状/尝试性动作	解决办法
无法进行上传	要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。同时此页面显示有上传限制。 当你尝试上传一个文件时看到了什么？错误吗？ 确保PHP的upload_tmp_dir配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样的情况。
无法上传大文件	参见常见问题：为何我不能上传大文件（1MB或2MB的文件）？
点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE	参见常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？

登录

参见常见问题：I can't login anymore, what can I do?

错误症状/尝试性动作	解决办法
Login fails with error / warning	Forgot password? (does email not work? Contact admin, admins can use login.txt instead and fix email or reset the user account) Do you have any special characters in your password? Prior to Gallery 2.1 this could lead to login problems under certain circumstances. Consider upgrading your Gallery. Does it say your user account is "disabled"? (since G2.2) Use the "Forgot Password" link on the login page to reactivate your account.
Login fails and just displays a normal Gallery page again	Often clearing the browser cookie cache helps. Check your web-browser settings and clear the cookies for your Gallery website. Sometimes, you are actually logged in but still see a page that looks like you are not logged in because your browser did not update its own cache. Please check your web-browser settings and clear the browser cache. Is your webserver IIS/5.0 or older and is your Gallery 2 version older than 2.0? We added a workaround for an IIS bug shortly before the official release of Gallery 2.0, you should upgrade your Gallery.

工具包/模块的激活

错误症状/尝试性动作	解决办法
There are errors when trying to test the binaries (or when saving the configuration)	参见：Installing an Image processing Library Does it report that it can't find files at the given path? 参见the note about the 'path' in the above linked article.
netpbm reports 'errno 13 (permission denied)' or ' Error reading magic number' when testing binaries	If you are sure that filesystem permissions are correct, please check Installation on a SELinux Server as well.
Windows / IIS specific: I cannot install any binaries	参见Installing binaries on a MS Windows / IIS server
Windows specific: Warnings about 'unable to fork'	参见常见问题：I get lot's of 'unable to fork' warnings, what should I do?

外观主题

错误症状/尝试性动作	解决办法
Can't upload theme into themes/ folder	参见常见问题：How can I upload a theme or module via FTP when I used the preinstaller?
Can't edit theme settings	Does it work for the 'matrix' theme but not for a 3rd party theme? Then it's probably a specific problem with the 3rd party theme and you should contact its author. Is JavaScript enabled in your browser? Does it show no theme blocks at all? Maybe your webserver is not configured properly and blocks JavaScript requests. Or it doesn't return the right content-type for JavaScript files. Please browse to http://www.example.com/gallery/lib/javascript/BlockSelectWidget.js (change the URL to match your Gallery location) and if the JavaScript code of the file displays correctly in your browser (or if you can safe the file on your computer), then it's working fine. If not, it is probably a 'mod_security' problem. 参见：Known Issues -> Apache mod_security. Your webhost should be notified about the problem such that they can fix the webserver configuration.
Nothing works anymore after changing theme	参见常见问题：I have changed the default theme and nothing works anymore. How can I switch back?
Can't reach 'Site admin'	参见常见问题：How can I change the default theme when I can't reach 'Site admin'?

模块

错误症状/尝试性动作	解决办法
Can't upload module into modules/ folder	参见常见问题：How can I upload a theme or module via FTP when I used the preinstaller?

翻译/本地化

错误症状/尝试性动作	解决办法
Changing language does not work	参见常见问题：I changed the language but nothing happens, what's wrong?
"Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request"	参见常见问题：Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?

其他

错误症状/尝试性动作	解决办法
Blank / Empty Page	参见常见问题：I get only a blank screen when trying to view my Gallery. What's wrong?
Error when editing an album / photo item	ERROR_OBSOLETE_DATA? -> Clearing the cache might help: 常见问题：How can I clear cached data?
PHP memory_limit - Allowed memory size exhausted	常见问题：Why do I get the error 'Allowed memory size of Xxx bytes exhausted?
Performance - Page loads are slow	Is the Server CPU, file I/O or bandwidth limited? 参见：Performance Tips
Nothing happens when I click on a link / thumbnail	Probably due to a memory limit or a fatal webserver error. 参见：常见问题： get only a blank screen when trying to view my Gallery, what's wrong?
'Site admin' link does not work	Does the link point to '/admin/'? If so, then it's likely that your URL rewrite module doesn't work correctly. You should disable it. 参见：常见问题：Images don't show up and the album / photo links don't work, what can I do? Also check: 常见问题：About blank screens (the notes about memory_limit and webserver error log are helpful here too)
'HTTP/1.1 503 Server too busy' with IIS / fastcgi (usually just for 'Site Admin')	This seems to be a bug in isapi_fcgi.dll (the initial fastcgi implementation). 参见the resolution of PHP bug #37448. We suggest you rather try mod_php (instead of fastcgi) or you can use Microsoft's IIS FastCGI component (a more recent FastCGI implementation) or use the Apache Webserver (usually easier to install, it's our recommended platform) instead.
No edit link / cannot edit album / item	In case you removed the 'Item Actions' block from your theme settings, Gallery should display a small "edit" link in most themes. You can add this link to your themes with {g->block type="core.EmergencyEditItemLink" class="gbBlock"} Else, verify that you're logged in with the admin user or any other user with sufficient permissions and consider clearing your browser's cache.
Some Error (don't know more)	Enable buffered debug mode to see the exact error name. 参见the below section about 'troubleshooting by error name'. Does the error occur when browsing to your Gallery on the front page or only when you browse to a specific page?